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When using this document, keep the following in mind: 
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This document may, wholly or partially, be subject to change without notice. 


All rights are reserved: No one is permitted to reproduce or duplicate, in any form, 
the whole or part of this document without Hitachi’s permission. 


Hitachi will not be held responsible for any damage to the user that may result from 
accidents or any other reasons during operation of the user’s unit according to this 
document. 


Circuitry and other examples described herein are meant merely to indicate the 
characteristics and performance of Hitachi’s semiconductor products. Hitachi 
assumes no responsibility for any intellectual property claims or other problems that 
may result from applications based on the examples described herein. 


No license is granted by implication or otherwise under any patents or other rights 
of any third party or Hitachi, Ltd. 


MEDICAL APPLICATIONS: Hitachi’s products are not authorized for use in 
MEDICAL APPLICATIONS without the written consent of the appropriate officer 
of Hitachi’s sales company. Such use includes, but is not limited to, use in life 
support systems. Buyers of Hitachi’s products are requested to notify the relevant 
Hitachi sales offices when planning to use the products in MEDICAL 
APPLICATIONS. 


Preface 


This manual describes the SuperH RISC Engine Assembler (hereafter referred to as the 
assembler), which supports development of programs for Hitachi SuperH RISC engine family 
(hereafter referred to as microprocessor). 


This manual is organized as follows: 


Overview: Gives an overview of the functions of the assembler. 

Programmer's Guide: Describes the assembly language syntax and programming 
techniques. 

User's Guide: Describes the use (invocation) of the assembler program itself and the 
command line options. 

Appendix: Describes assembler limitations and error messages. 


Read this manual and fully understand its mechanisim before use of the assembler. 


For information concerning the related hardware and software, read the corresponding manuals 
and understand their mechanisims before use. 


Notes: 
* The following symbols have special meanings in this manual. 


<item>: <specification item> 
Blank space(s) or tab(s) 
%: The OS prompt (indicates the input waiting state) 
(RET): Press the Return (Enter) key. 
: The preceding item can be repeated. 
f i: The enclosed item is optional (i.e., can be omitted.) 


¢ Numbers are written as follows in this manual. 


Binary: A prefix of “B'” is used. 
Octal: A prefix of “Q'” is used. 
Decimal: A prefix of “D'” is used. 


Hexadecimal: A prefix of “H'” is used. 


However, when there is no specification, the number without a prefix is decimal. 


Windows°95 and Windows®NT are registered trademarks of Microsoft Corporation. 

UNIX is a registered trademark in the United States and other countries, licensed exclusively 
through X/Open Company Limited. 

SPARC is a CPU and workstation administered by SPARC International, Inc. 

HP9000/700 series is a trademark of Hewlett-Packard Company. 

PC-9800 series is a trademark of NEC Corporation. 

IBM PC is a registered trademark of International Business Machines Corporation. 


Contents 


Overview 
ah Eris spss sn icv ass sted comnnitiocateueh eae eaeneramieeunas 3 
Section 2 Relationships between the Software Development Support Tools....5 


Programmer's Guide 


SC CMM a2 EG, | ne ee, are eae 1] 
Re): a ee ee ee 11 
DT sdDacsl) “SAGO RI RSS Cad UENO es EN a enna Sone Seni dle wana coun uee etapa Casinepmeatind 11 
J Kick Coir iE Sea Sea sacra ses csensarsicrerncerincinsarccensstecrae cnc lnaeanseatsbacensibatsitsith 13 
1.1.3 Coding of Source Statements across Multiple Lines .....0:.:.:...esscrscsecvereansicenneees 15 
IL DNRESEEVEG. W OLGS ise: tincsereptes nc maeusvawetanawacedteeivdaces ervmaswadanben dese sascineemsbuteusidoinatederemmonmneeteuedeeets 16 
ke chennai i bt ai ile 16 
Bh Ea ET PI tse sornnescenerenesercnnsre bmn bit ee NAR a alansnachbe 16 
Dp an RR RMN sp cnn ec intend nace 18 
L&C ONS TANS so cucsmamncesvanewardevncesasueeremenene newsman dnoosercneranataramemrenmeom vera emm ERENT 19 
JA Win te Set CONS TANS wie ca sscissnnvacescrsdecessnasdeesuspensdovaevetasoesspessnessisian stesierneeremnes teens 19 
1.4.2; Character Constantia: cites ie mscemasman acorn 20 
14.3 Bloat p= POlnt COMSLAMIS 6 usocconssevesensasapesenemnnespecsenicasnesasessesdase ts sunsnicartsdtesBenseunes 21 
44h Bixed=P oii t\C ONStARUS scutesonsssnsesexernsesnsewroenatd vane enaniitasearunes wravaecenasanenabensewsrenine 26 
I SOCAL OM COUR ois setsct te raatswentstaiawndnivenewrenesetpsusmmasnnnes sudicdctumetbcestueum svat Sremwanouten tee aaetel 29 
16 EXPLESSIONS saxcessnerscuwees seereruwesn seseramcceneatenee taney vemawereanerersia an taeaeereaeee RemaeRNNaeer ORE 31 
Dh a NR A SN np sxceacxsicsacinemenrneeensavoienciiace ces nuevos seunonignmcreiuintianivedadtenwts 31 
16:2; OPSratOm PreCGeN CS ss. «cz, sas conn. nnccanenvasosexessedataeasaa senecetatecenmestiormeemnmeneddmramen 33 
1.6:3 Detailed! Descriptron On Operation wes cvcexesescnsxvovesenovssenaoodes voteeeuentexexeatececcdtheceeesemwe 36 
RG GUN OteStOMEE MPLESSIONS tance catsiesanorececesunqnanesdiionsaonnebsansnsvededtyadeepadesenskebandacoeanavesvacdvannen 39 
Lhe Gara Cte SOS eas sea seieae tenet viseoecenseuhAeduas sp sexemcereecseen enone ude ennceseanenesen ep seeeolaataesinesueateats 40 
Re AMEN RN escrito sitll sacl ce lsoieloeaeens 42 
ES Trae TA I Ge etsccnsr cease rnc ieee cise cemmetasiaiteabin i 42 
[the Cremer iy PACT ial eat Ter tiie soon cciprenesereasmnrerenanenemenreaninintemeigciinnemmaiensinnt 43 
eae aes PAO ao cscsnitnicnawnmrertunrenscniantan anion Caney dan nDighi ehh alm npLNn EA 43 
Section? Basic Proetammine nO Wedge ..000...c0ncccoersnasscacesonassasensnebecpversaresnene 45 
Du], SECHONS xssiecsemans enamine sieuonas Keerease mT oO ERNE ROME RTT ERE MONRO ETET 45 
Ce de a ar ner 45 
2.1.2 Absolute Address Sections and Relative Address Sections..............:::sseceeeeeeeeeees 50 


2D, (AOSOlUItE And IREIAUINE Vial OS ioc seararasceseuseestmoneusieeaiaeh soamenvaianean veneoennsaiacespavestacemnesssenasontens 52 


22h A DSOlUTE WAC ioseciia aa i cowarerbanweticnawanaeua/capwacdwaiwewa ne neen demadinwnns Wawerntw ndaneanadesdebacebuoessedonios 52 


DDD) REIAIVG! NV AINIES xs.caz cies se sxomennancss axenonsn cate dneecacan cael sn ta vanes ceveneveasous snaece su smeanench Mooremeeete 52 
2d SURG! DST ICO BHO Fe STN pon a mnsnsinsitenseasmemartneearohanemmnnatineamennatRouamenenes 53 
RR Ee ME ee er ee en eT a3 
Hecate PMR CAN NIN st sn i Rm nv ae 55 
QA Separate ASSCMO Yt csccscavensesesesemeirereetaceseredicacdasesioumm see eaiusuncveeweewreeueeeememenmienmenraae ns: 57 
DAN Separate ASSei Ol Vi .ciccxaceeecuocnsasesvanuscmows sessictuedsdeysvescenannd anv soesedersaniodeancdasemaonseparseos 57 
2.4.2 Declaration of Export Symbols and Import Symbols.................::cescceeseeseeeeeneeeees 58 
Sec rieres 4 Pacers alias Tres ssesisscsicessceciss encansanbaastdionscandusdasebnadeonesnwaatsandoances 61 
Bo Cv CE Cui NEALE sees steniccosscoyitenrraantebannaennnensncnntaisanaaananinencsbiceniinseutennisniihies 61 
Socal, ECs uni orca es arr NING an ncn sion gvsetesny entation inrcmecseissiasarupmabinn oaintieicsmcseaneinainennseiestiaions 67 
Slcl, (NOISE 00 THe CEIANION Bi ccnsescaiccanmcnsarencrernnnon enncansnareninasermauinnenmunsianaieniior 67 
3.2.2 Notes on Delayed Branch Instructions.............ccecsecccesseeseneeeeeeeeseseneeeeeeeeeeneeeeeeees 84 
32.3) Notes onvAddress Calculations encrertecccacosicencenmecrerin eee ise EE 86 
SO TO TEI cca. scnccasienia sxceeanniancaes tens deanmeinsciadbewon acnicasinianiianes 91 
ab PRO TIE ncaa narchorsaminenninmennncnaian talent nvnan eiaratiendemuiienpaaieememamiamanineenisleniiuwetans 91 
A Teall SOURCE! SCACSIMETEG sa sdsetnn sae ctegemewen sans eeoawtonensesturaoaneteapassoncwenserwenndageuensnanagaienuuset 91 
dice pert, Chppereriiar: Tere tG OIS ies sceciestosnocsnies mrinstststsneertiseicammnasineuniaaancmamissimanaunates 92 
4.1.3; Data, Move INStTUGHONS... ....0...sesensssienesseneessesicadovssevencoenesenonnceessoonsvaawosdacesteaeineston 93 
4.1.4 Coding of Source Statements Across Multiple Lines ...............cccccceeseeeeesseeeeeseeeees 94 
Bee NRE NUR U USNS cranes cscs pr scree te chan i sg ia NNT hewn aint lessen 95 
4.2.1 DSP*Operation Instiuctons xca..sscnsscssnvesaessevesnesesseeteesessevsesenes questavesesvessanssesnesevss 95 
4.2.2 Data: Move IMS Gtr OM wc. ccc. cascoowessvsvcederesogeavovess«soeteessoesvvederonssesncetencsaninehenectaceses 99 
BECHON S sASSOR Der WCIVES aoc ccs cease osorninnconrarsenensewensntesomensanivtquetosenvsitwasiye 103 
5.1 Overview of the Assembler DmeCtiy 5 iececcesons cecstcnzvacncsneanieataneuzsiyeeennsancenensmereeseseeenesaneeee 103 
Dit PUSHED LTOCE WS FRET RER EE sn cancccninnciins saan vennnsiiciindecunnsssiehsinnaneniniecututasiewsivintapunpennicevminedl 105 
S20. Laneet CPU Penier Tt osteracerkcetesvewtarrenaseneesncmanosssxamirrennandcdenatanaicunans 105 
A MR teh yi hae ei eeenipc solapisesanclaielaha 106 
5.2.2 Section and Location Counter Assembler Directives .................00ccccssescccsssscesssees 108 
1 Ue | Sn, one nanan ane ee a ee 109 
MSIE ssl eso is at as UA Na Sa ln dna scan oniecisnn nena toni 114 
PRTEIGING ccssncte aan cesianttit Stuatonsciestyeenedeasaensaeneserseustsentiveduts ses ve teenedecaum inner ete 116 
5.2.9 SymOol Hahaling ASSEMDIST DISCH VES 5.22. ccsacasnnnnonnnenonsncinrnionnaisnnasinndennceanneins 118 
TO) escarole raardes esis i ett oep cetaceans ta aetero mimic omtaattne Be aay eeaeemnee eee 119 
SSS GIN 5 cs scercaiptci sitar eatepiaphuoniocasaiwetlssauaynwontie duatesyannpada leds uenvatatenevedieiionsterees 
FRE Giwrermwecntecersts cn stint cat suc ema anienane neseen est vaste Sis wealse ten amo haced SeR do nated aexensBNOR NERS 123 
|G bal CAC | eee en eee ee ee ee er ee ee ee 125 
5.2.4 Data and Data Area Reservation Assembler Directives.............cccccccccceeeesssseeeeeeees 127 
DLT, scccenasesmte ines sss ana Saiasba oon aerecbend mats edtasi De no Sean nnd ama 128 


SAA Biase sinssccot eres sete ae eerste tea hier eta tensed ner cennacampeaewietasmapneneeeceeoaraues 135 
Se aL a i ssc gi incscuacbfaleteaesnanne a etapa Mowe aeeea gene tanaahiehteginasedaaisideitanarinse 138 
EINE ccnp st ti cs PE eS Le 140 
Ee eee ee a ne eee 142 

BE aa si sak seca ens therein eelondah coh bnecineinaleshincesatenceuacoetiantaansitl 144 
SAG Ms centric i LE eC ERB 147 

DS a a en ee ee eee ee 149 

gE ENE DS eet cece eth aR ae ern nn hn napa tons bee 152 

Bae castles eesti eae ei eal cts cbse 154 

SERNSI ER neskt cae il Cei el cheb ec Nieto tacecinernbsaeinealaileocensanainssiestineatl 156 

IP RISSS sexiest BENE a CN ONSITE TA 158 

3.2.0 Export and Inport Anseiiiler DRC VCS igre ssescincsnicersermmencacenrcnncienannen-eoamcononnens 160 
STI NIE ets eSNG Bll ui i ea i es ci skeen sgh 161 
SONU ncn cntveiccn necesita ecb asec enced enainsocapeeteniancananiiote 163 
ERI sists miei seats Neca sie ese ssneendearnlemtacionil 165 

5.2.6 Object. Module Assembler Directive vccsvcsscssexsoseaveseseseusenessessseveceuasaxeseennccacspooedane 167 
Tr cit apace issn greases Bld nde eneoeeiirenctia 168 
DG accents anes i CA CU EEE RE SNARE 171 

TSA NIN ssn Bae Retro ate rede a taaain gains Tniceignlepsdeslaapinwamawanenucbianivcedcashassptooeomameanaes 173 

LIN E wo cussessstseacecsuaessveweseuexitsiernemnixommmsa trae A EISLER 176 

3.2.) Assemble Listing Asset bler Dire Ct G8 is cosccnsrcsecceesesnresccmmmpenseneemrcnccmanseens 178 
PERT ssesssapnceeics naan tte its estas ARNG hs ROR RAR aa CaO RUNNIN 179 

Oy iecaitancgasasnni slime calc ta eatin epson eamengy navibaenenieieeiatiasapanaia 181 

FEE rr ures sehen an cs anseesinn cram aa actin ANA KRAEMER ARR ARB RNA 185 
Be cer cmsnsceieptgesetonishecuniicaahisepepn eit an clade ueaaiaatonmenascaanenica onsinmmimmiiastsh 187 

BAGS, scsescasssseasimsmnesie tata aise ROS RT RA RSCTA RET ASA ARRON A 189 

i ene oe a ee ae en eee ee eo ee 191 

5.228 Other ASSEMBlLEMDILECUV ES sc ccsseesvanctsscsenoneseapcc acess siaenaenn caenwarannecmervaneasesecscontevests 193 
PRO GRAIG occosceswensescntcicavsuctvtibneteetevemteseereurdensdetudtioemneneunucnuntonanebsnunarasateas 194 
TUAIIEX, «. esshivursemeswassp tecosawateh acebeasdedeisGaeindee esccnesesnsan dil done sponded Sasceaeatamesack akeeiss 196 

TU nti iain inc eth cnn ecenadmeabsi 198 
SCO ii FS TC GCE ccnicc cases trenurr xccmnwecinns Surcran sous sismmismennaunmemteens 201 
ace eennceeretors ecient nie eonic spend cea icea a psa aan passionate sais 202 
Section / Conditional Assembly Function cncsnnsssssansesxeaesencnneseanenmnwseneeieonsees 205 
7.1 Overview of the Conditional Assembly Function «asics cecscsnyerevecasscmensrssevnneansnsconmennacnaniia 205 
Tide PRE PPOCCIOOR VITALS occ ssccscnsscscxcanenansacannsennenanin sxcanmnnconnassannanccenapeeneesecesneRinRenwan 205 
PPD FReplaCementsS VIN O!S vceeed vac eneentanosmneuetuesnedtinnneratusessbesesnacanienerestanedtpnocurenneeneretes 206 
PMS} Condition lWAS§ C10 DY vce scesesciroewsdownicowitiadwbedevedurd dedodaseasiodibc.mersesunec tadasaenhoanicsisone 207 
TTA epee, EB ONGI OG woccsasasevccssevcecsccanwaxumemesnasnersnamamarnunnananansnaeprinenmanemunnnins 209 


of ge eR eee ert ET cis ssoninrrtsneconsenetonanminanienornenormeeemmnemnmeneenes 210 


2.2 Conditional Assembly: Dire Ct ves. swisaceccaeesoencanssnnuesuniscwaonyicenenvasceestetinpnenacibvoasasaeredentasaeuoanee 211 


sean BALI sith ln sii aS oe Dea pc 212 

bce) a a ne ee 215 

Tr i csctpilt cer eeroerelncasg ices ca iene tees 217 

AID, cE, PSL, PID sss ta snccrscrscinninn sataamrcnanenaanaanesanat om ecasmimaresaenasaet 219 

TROIS, ih ge, MENON pcrmce sane caniinatonnre tana iananinetisuornaessiesinnnuniasocnadccesans 222 

PEC EAR gle PN sieist teicassieniecomannandenniasvatam incase msg Rippon asset tanaadig bil 224 

PET, EIN ccs enicensseenscericecsmssiwas ec tacit ea a a TSR 226 

de AI geval tac ees ahecmomaponagtas 229 

[| nee a ne One ery One ae Eo OR Eee crete eee nT eee ee CRETE 231 

CAN |), 233 

BARN, Tea TR seston cesta acetone 230 
Bok, Cpr wk Tne Br CO en eviesiconerncconinscdcncarvenenees avandia tatnapelsaineneciienictortersis ebnbincse 235 
By, BORIS FURR TG TIE ceca evs crt ea Sn ti ec aca ES yA | 
Ba | ee a ea een 238 

PI zc cece twa asa dcbc ew trocar ts aCe aa eta aaa tae 241 

Fe A ER ernest astern cacenacertoriearmecnnteannanqncinenanoninneniadnmtagenenannalinnsisontaimnnasaciadenge 243 
Baas TaN I ssn eae i ic a naeessinesn ne ern ic ce siege a ceata imetctanaiSaaoeo 247 
6.5 Character Sicims Mamipu ation Fant Qt os ccerwcen quineesnniccnrssecasnguxonetsxonannssionnenmmnionmnmcntanen 249 
SEE asec cs ei Ba Me eta IUCR en dl an sin etna tn aceasta le 250 

ph i ae ea ee ea eT Te i 

MU rnd care iat nib tect ninan slg sean eon la mtn a oto apa aebin 254 
Section 9 Automatic Literal Pool Generation Function. .............c:ccccceeesseseeeeees oar 
9.1 Overview of Antommtic Literal Pool Genet aA Ott vsccccenviccsccnsecensimnnrvanasennesavunenmaammacseniine 257 
9.2 Extended Instructions Related to Automatic Literal Pool Generation.................cccc00ccceeeees 258 
2.3 Size. Mode for Automatic Eiteral Pool Generation ccc ccossssancacseacnnasannunancnssancvupaseretnesniineswanes 258 
Ee TTP OPAAE POL CRT ENE scores secrcaseaotenices insets pnteieamininnnnlanisiam saosin agaaianesiladanbtaniiteaianolteaetins 260 
9.4.1 Literal Pool Output after Unconditional Branch......................sc0sssseccssseerecesseeseeees 261 

94.2 Literal Pool Outputto the: POOL, Location .....cccsevrrsecovsscnssiexdeenevacuiteonenesessnemecnnes 262 

Bd Ar By cae snares sc repeat acta oct iemsnmes vag 264 
220 Litera Pool itp rish Beet GA ON oi ocincincaneiconnenncensiveera commenceeneesasauneaseererbinattmesiesnedetnaueanien 266 
9.) Mates on Automate. Lateral POG) Oi pitt cssscsessasnercanisavansrccncncnncvesilna dotasvesusnnanthaianseaseasenssionns 267 
Section 10 Automatic Repeat Loop Generation Function .............:ccccceeeseeee: 271 
10.1 Overview of Automatic Repeat Loop Generation Function .............:c:ccssseeseseeeeseeeeeeeeeees 271 
10.2 Extended Instructions of Automatic Repeat Loop Generation Function...............::0:00 272 
LEAS: POS, TSI INN cases cnc icaciresncsh cota ican sects nad mshmsiondhonaseclabi sided eps aissevian ts 272 
SEP ANI, Te ERNIE anthesis a ecole a 274 


10.5 Notes on the REPEAT Extended Instruction ............ccccceeeeeeeecececcceeeeececuueceeceeauueeecensueees 277 


User's Guide 


Section | Hxecuting the Assembler... ensorsnavsorensdacvenevsersveedvaseroanesnanneteans 281 
PUG Gi ries BLE is ted] 330 1 Seow ee enon, ee eo Ce ener ee aera 281 
ce a EA rrr a oie cr srr Sant edastonennveao sunnaninncometneamanaconmmecinneansdameleemanaigetae 282 
Bh oe aM aN TE TA IL Oo accreted Saansrodd cuateneteneeicnmamtabibaienleiacninniniieaainsniouonntinabdctasit 283 
SSSton 2 vConmIatid Time OOM OS ocnccnsews<nsscecisunensexessienmrnions<eusussormeanserenciam 285 
2.1 Overview of Command Line Options ..............cccccccceeeccsesseeeeeeeecesssseeeeeeeeeessseeeeecesstensaseeees 285 
de CGI Ti EE ORIG ss osteccc cpesiecausanccnancanowemnsaunnenaoiacenrneumensiecdatameschinnapuueads 287 
22.) Tarcet CPU Command bine: Op tho mivieec<.osscvavnnaeweracestiweseecenccsiossevecssteasessexsnennssenes 287 
RI casita it SRE ac cg och cea psa 288 

222 Object Motale Conia ir O01 sss cea scssnenscrnorenxerconvencnnnnncwananonmvesiascien 289 

aM DEAL OGM MLGEL, snscnhes manson esa sia sind inthis lonesome enmeassine 290 

we Faye OH MIGT cericnrneveviarnnexesioincenesnittsiceenanianennmaneai na cngnameinamnEaTE 292 

See AB egies 9 oa nang a cats sche able neds shaaidedeiapwcaldaseahipacie 294 

2.2.3 Assembly Listing: Command. Line Opts nsec scscccsacsexareexuesowwssxeearesrwnrvesvwcaceversuoes 295 
ee AS a ee ee eee ee een 296 

SF Re i OTE IRE iss canes tancscanekawananenits sostaiaa bicslekadndaldsonintasenibnaaacdannnnaenaiian 298 
—~CROSS_REFERENCE, —NOCROSS_REFERENCE.......-c.sscssessssoscsenesconsnese 300 

Re UCI p= Pye A EIN ois ca tenmamitnaneunvaiteasiniaiseiveinaccnhannimadaninshaiiseateentacnadinn 302 

Sis et Oren ccccrnensecauinsecperanstonecieucamtenienoen nei taned asnenbumiapocssisennensomsedaesiaeis 304 

ca cg anit gine MR apn nuh Rl et ch oe eee 306 

SU a ae roe ry 307 

2.2.4 File Inclusion Function Command Line Option...............ccesceeeeeseeeeeeeneeeeeeneeeeees 308 
=e ee 309 

2.2.5 Conditional Assembly Command Line Options.....................cececc eee ceeeceeeeeeeeteteeeee 310 

Sy Ne Becca teers pi i anatase 311 

Sa MNS csp no nn ch ah aio iene sagt ee aon cE 313 

| ere 315 

2.2.6 Assembler Execution Command Line Option...............0.cccccceeeesseeeeeeeesseeeeeeeeeenees 316 

A NOUN cas cs tL ca pi US de 317 

Naa cece Nahe ee i Dison cern alascmiadasg eines 318 

2.2.7 Japanese Character Description Command Line Options............0....c eee 319 

| | ee a 320 

EN AE a cin is tsenlitpet ase SG se letdown bases clea 321 

Se scsi sei 8 HNN ARNDT RINE aE 322 

2.2.8 Automatic Literal Pool Generation Command Line Option ...............:::::eceeeeeeeeee 323 

sg NS UD AN RIN cnn hese tn pete iid tr tnd ca ea Sot 324 

2.2.9 Command Line Input Commatd Line ODO. aecssiccossenssccccaravecresevernsnaasvnuerverenns 326 
MeL INL areas saeataciera peers gets paisanniinnuociiheiparyentaedmesanmenmbuensuanmecuanasans 327 

2.2.10 Floating-Point Data Command Line Options.................eesseceeeeeeeeeeeeneeeeeeeeeeeeees 329 


UE BE esa ex cnsscccnsrs nacre se aha cis asistencia ana thas san 


Appendix 

Appendix A Limitations and Notes on Programming...............ccccccceceseeeeseeeees oof 
PPERGie. BD SAMS PPO GLA ens casees ces inane coccsvenciainensveeanmnntsmaemssexavenwnananeniienns 338 
ED k SSeaR ALS PROPANE CIN scsi ans ccrsncsaintion cso gearrianctnieninavinca be eentesininoueniicee Nusamusionncs 338 

Bee ME ERI eases cl ce ome i Neda 339 

Appendix C Assemble Listing Output Example ...........0.....ccccccccssseesseeeessereeeees 341 
Se CNN a saceerrsecaicgrese ities sige raichal nanan nitatad nce aiamicasomcee 342 

as a eR Ee EN TTI IN csnascsn stisinetersaca gi ynenanescdcnitarncca eter speak arcununieeonuteensiacniio 344 

oes) CPE eas, WENA DS ie snc encrescseect oa srs cs geen asics hceikalaisaaaalbainme Balak spain 345 

Peirce TY Tera WI sc ssc srcexsisvasntcsinasnanccostsbatis sees niaiaadaniinntnaniimimilion 346 
ee 2 a ee oe a ee eee ere 346 

EZ BERNIE ISSA EES es rcesscc cscs uaicicancnasmt catalase pas aas necometacoebnsicatecnsonhoniadelinwaantoerinmeen 349 

Appeodix BE Ditterences: from Versions 3.1 5 .cccicscccnoscssoccresenenndcevernenepereonsntarenes 371 
Fe MRE TO rics neti tr oat cur meanness cil kina ater 371 

Be OSI, NIN sessile Zn en aetna then csi wcrc ei itemise 371 

Lg nS a a ce era ee 372 

BA CHRBRER ASSIST IIIPORIIVES ssisscciiaciiansccnnscncncsaguiisestiinnananurwrmnnmahonowe dnianebiioendivbwmpeenkamnecnenen 372 

eR ee ee ECL | | Lene: ae Teen 372 


Appendix F ASCI Code Table: .cccsecrcassncnssnve sieve nsawnenenueencuscaccuvsnnmcpivsconsnanint 374 


Figures 


Overview 
Figure 1-1 
Figure 2-1 


Papin iE Ce ei acca. cx sarenemeandronasiconmeeeemnnaa ieemeeenemenRRiweNNN 4 
Relationships between the Software Development Support Tools ............ eee 6 


Programmer's Guide 


Figure 2-1 
Figure 2-2 
Figure 2-3 
Figure 2-4 
Figure 2-5 


Figure 3-1 
Figure 3-2 
Figure 3-3 
Figure 3-4 


Appendix 
Figure C-1 
Figure C-2 
Figure C-3 


Memory Reservation of Common Section ...............::ccceccceeeeeseneeneeeeeeeeseeeneeeeeeees 47 
Data Structure Example Using Dummy Section ........0...cceeeeeeeceeeeeeeeeeteeeeeteeees 49 
Meaning of the Terms Forward and Backward ................cccccecceeeeeeeeeeeeeeeeeeeeeeeeees 55 
Meaniticot the Term Ee xtempal ccs edescerassensemscsuersesscarsnateanvcesaveeccasvceaserersaormeaners 55 
Relationship between the Changed Range of the Source Program and the Range 

of the Program that must be Reassembled .............eeccccceesseneeeeeeeeeeeeeenneeeeeeeees 57 
Address Calculation Example (Normal Case)............::::ccceesessececeeeeeeeeenseeeeeeeeneaes 86 


Address Calculation Example (When the Value of PC Differs Due to a Branch) . 87 
Address Calculation Example (When Microprocessor Corrects the Value of PC) 88 
Address Calculation Example (When Microprocessor Does Not Correct 


the Val OF PG) ooo ect cscuses seca seaneeenanernneecanas acvessecesea mamaannereaneuentausonemmeneneesane 88 

Source Prociam Ibisting Output Example un. sciscconssacsnesasormonessesrscvenernennsannssensoenswes 342 
Cross-Reference Listing Output Example .............ceecccceeeeeeeeeeeeeeeeeeeesenneeeeeeeenes 344 
Section Information Listing Output Example ..............eeeseesceeeeeeeeeseeneeeeeeeeeeneneaees 345 


Tables 


Programmer's Guide 


EOS Ea AMRIT NAY ION, TM assnikn onan enta annie dyinsroNtaraiinasctutinctn olen hase cacesedeaninccwennibaniie 22 
Table 1-2 Data Types and Numerical Value Ranges (Absolute Value)...........c:ccccccssccsseeseees 23 
LegRAESs Me LIB U TAORRIN IS a saereseirscninasiaoictvn nschicieeasieesos cenaute cure gmnenuevctces sees canaries 24 
Table 1-4 Floating-Point Representation for Each Data Type ............ccccccsccssecsseeessecnseeeseeeseeees 25 
PI Et sees nts petnsen enticement albino eis il da lobeloeiaeta 31 
Table 1-6 Operator Precedence and Association Rules ............cccccccccccessssceessseeeeessseeceessseeeeeees 33 
Tipo Te EE weea Oe Opt ssccscssrnr eco wag ansin e nonitapuna thal ssdiviaebethactnselaiaaasti 38 
A Bc ee ne eee nes 62 
Tile 5-2 ATO wed isp CeRAetit VBS siscccacsccasavsansinspensviicedeintennneidandensnpaanlasentistiesataienoucesiinbiows 64 
Pauls 2) AO wer anaes VANES ceciesnoxmncarnmeanaioneesmatcanceunniannnieennansiedenamenaitesciiaaies 66 
Table 3-4 SH-1 Executable Instruction and Operation Size Combinations...............:cccc000000 67 
Table 3-5 SH-2 Executable Instruction and Operation Size Combinations .................00.cc000- 73 
Table 3-6 SH-2E Executable Instruction and Operation Size Combinations .................000600 74 
Table 3-7 SH-3 Executable Instruction and Operation Size Combinations ...............:c0c00000 76 
Table 3-8 SH-3E Executable Instruction and Operation Size Combinations .....................065 78 
Table 3-9 SH-4 Executable Instruction and Operation Size Combinations .............0::00c0c00 80 
Table 3-10 SH-DSP, SH3-DSP Executable Instruction and Operation Size Combinations ..... 83 
Table 3-11 Relationship between Delayed Branch Instructions and Delay Slot Instructions... 85 
Table-4-1, DSP Tnstructions tn MMe motte sanosiecvesniasccsasenasacrenerveausssesanneonvanceasiannenusomnteroesseouxes 95 
Table 4-2 Addressing Modes for DSP Operation Instructions..............cccccccccccessceesseeessseeesseeees 95 
Table 4-3 Registers that Can Be Specified in DSP Register Direct Addressing Mode............. 96 
Table-4-4 Ranges Of Tiediate Date sascwwssnsioceussninscaissaveceiaiisescecasnananesannoosanconsvoeaigeceenscbavsdnsaauns 96 
Table-4-35 DSP Operation Instructions........cccsessossexssornencorussnyesdwsavsscansesisonnyansvasenvesseasneseannenee 98 
Table 4-6 Data Move Instructions in Mnemonic...............cccccsscssceesceseesssesseseesscsescesssessecenesenes 99 
Table 4-7 Addressing Modes of Data Move InstructionS.............ccccccccsscesseesesesecesecesseseecesseeeee 100 
Table 4-8 Registers that Can Be Specified in Addressing Modes for Data Move Instructions. 101 
TAGE A-9 Data WOWS ISIC UCI coercnoxsuitnnasexosusoncosonsmexeuadonninunnsiancmnaniinnirpudsieminsialasuadinswewpicen 102 
Table 9-1 Extended Instructions and Expanded Results............c.ccccccccccsesseseesceseeseescesceseescesenes 258 
Table 9-2 Data. Move Instructions and Size Mode sevcisescsvcusncessavsansancenvicannnas ionvenves sensuxenessasavens 258 
Table 9-3 Instructions Selected in Size Selection Mode ...........c.cccccsessesseeescessesessecssseseeeseesees 259 
Table 10-1 Repeat Loop Instructions and Address Setting.............ccccccccsscssssesseessssesscessessseeeaes 271 
Table 10-2 Extended Instructions and Expanded Resullts...............ccccccccsecesceeseeesseeesesensesseeees 212 
User's Guide 

Tae 2=1 Ci LS CIB a ceincdsse vo svsanaidcuntenceapsemrinaceieninsammonenvniemncnsheinetmieuniansamsuncennenesiees 285 


Appendix 335 

Table A-1 Limitations and Notes on Programming .............c:ccccccsecsscesseesseeseeesscessecessseesecesseees 337 
Tile: =] \erereaniaand Eeai pa Ee 0 i cst erect dasa msasasnirradpasiaenorbniadvesteds 349 
Table.D-2 Source Piroeramn Recor Meg SA 8 sexe iu sncsoaawciencomsomenanrincmess dna ecncnannietananttiuoncusainlpanatves 350 


Table 1-3 Source Pr cram Warne M6668 OC aac sonccmsennrwannannnnerunignummnonassaseneielbsowniinassienavasiesins 362 


ABE Sp aaa Rea atc nce nceinniegtranichinernpnsrirche imasionigsieaetin ena entiemeeneninnanneNapsrene 368 
Table E-1 Changed Assembler Directives and Statements ...............cccccccecsseeeeseceseeeeeesseeseeeas 372 
Tapis B-2 Adoed Command Terie Ob io. cons cvinnscrscasomenamenrsaxncunsoannaneenenmmnnncrucicavimmasenneventis 372 


Table F-1 ASCII Code Table....................:cccccossssesscocccossseseccacssssccsnssscccnanatecevseveccaverscacsosvsseoes 374 


Overview 


Section 1 Overview 


The assembler converts source programs written in assembly language into a format that can be 
handled by microprocessors, and outputs the result as an object module. Also, the results of the 
assembly processing are output as an assemble listing. 


This assembler provides the following functions to support efficient program development: 


Assembler directives 


Give the assembler various instructions. 


File inclusion function 


Includes files into a source file. 


Conditional assembly function 


Selects source statements to be assembled or repeats assembly according to a specified 
condition. 


Macro function 


Gives a name to a sequence of statements and defines it as one instruction. 


Automatic literal pool generation function 


Interprets data transfer instructions MOV.W #imm, MOV.L #imm, and MOVA #imm that are 
not provided by the SuperH RISC engine family as extended instructions and expands them 
into microprocessor executable instructions and constant data (literals). 


Automatic repeat loop generation function 


Interprets instruction REPEAT that is not provided by the SH-DSP as an extended instruction 
and expands it into SH-DSP repeat loop instructions (LDRS, LDRE, and SETRC) that control 
the repeat loop characteristic of the SH-DSP. 
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Figure 1-1 shows the function of the assembler. 
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SOURCE program 
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» Autom atc repeat loop generation 


Object module Assemble letng 


Figure 1-1 Function of the Assembler 
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Section 2 Relationships between the Software 
Development Support Tools 


In addition to the assembler, software development support tools, such as the C/C++ compiler, 
linkage editor, librarian, object converter, and simulator/debugger are available for the SuperH 
RISC engine family. 


These tools assist in the efficient development of application software. 


Figure 2-1 shows the relationships between the software development support tools. 


HITACHI 5 


| CAl++ language 
| SOU IGe program 


SOUIce program 


PPP PPP PEPE EEE EEE EEE 


ile 


Miect conve ner 


Simulatorde bugger 


5-type-torat 
load module 


Library 


Figure 2-1 Relationships between the Software Development Support Tools 
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Supplement: 
Use a general purpose editor (a text editor) to edit source programs. 


The C/C++ compiler converts programs written in the C/C++ language into either object 
modules or assembly-language source programs. 


The librarian converts object modules and relocatable load modules into library files. We 
recommend handling processing that is common to multiple programs as a library file. (This has 
several advantages, including allowing modules to be easily managed.) 


The linkage editor links together object modules and library files to produce load modules 
(executable programs). 


The object converter converts load modules into the S-type format. (The S-type format is a 
standard load module format.) 


The simulator/debugger assists debugging microprocessor software. 


Load modules created by this development support system can be input to several types of 
emulator. (Emulators are systems for debugging microprocessor system hardware and software.) 
Also, S-type-format load modules can be input into most EPROM programmers. 


HITACHI 7 


8 HITACHI 


Programmer's Guide 


Section | Program Elements 


1.1 Source Statements 


If source programs are compared to natural language writing, a source statement will correspond 
to "a sentence." The "words" that make up a source statement are reserved words and symbols. 


1.1.1 Source Statement Structure 


The following shows the structure of a source statement. 


| 
| [<label>] [ <operation>[ <operand(s)>]] [<comment>] 


Example: 


This is an example of a source statement. 


Comment 


Operands 
Operation 
Label 
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(1) Label 

A symbol or a local symbol is written as a tag attached to a source statement. 
A symbol is a name defined by the programmer. 

(2) Operation 


The mnemonic of an executable instruction, an extended instruction, a DSP instruction, an 
assembler directive, or a directive statement is written as the operation. 


Executable instructions must be microprocessor instructions. 


Extended instructions are instructions that are expanded into executable instructions and constant 
data (literals) or several executable instructions. For details, refer to Programmer's Guide, 9, 
"Automatic Literal Pool Generation Function" and 10, "Automatic Repeat Loop Generation 
Function". 


DSP instructions are instructions that control the DSP of the SH-DSP microprocessor. For 
details, refer to Programmer's Guide, 4, "DSP Instructions." 


Assembler directives are instructions that give directions to the assembler. 


Directive statements are used for file inclusion, conditional assembly, and macro functions. For 
details on each of these functions, refer to Programmer's Guide, 6, "File Inclusion Function", 7, 
"Conditional Assembly Function", or 8, "Macro Function". 


(3) Operand 
The object(s) of the operation's execution are written as the operand. 


The number of operands and their types are determined by the operation. There are also 
operations which do not require any operands. 


(4) Comment 


Notes or explanations that make the program easier to understand are written as the comment. 
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1.1.2. Coding of Source Statements 


Source statements are written using ASCII characters. Character strings and comments can 
include Japanese kana and kanji characters (shift JIS code or EUC code). 


In principle, a single statement must be written on a single line. The maximum length of a line is 


255 bytes. 
(1) Coding of Label 
The label is written as follows: 


¢ Written starting in the first column, 
Or: 
¢ Written with a colon (:) appended to the end of the label. 


Examples: 
LABEL1 ; This label is written starting in the first column. 
LABEL2 : ; This label is terminated with a colon. 
LABEL3 ; This label is regarded as an error by the assembler, 


; nor terminated with a colon. 


; since it is neither written starting in the first column 


(2) Coding of Operation 
The operation is written as follows: 


¢ When there is no label: 


Written starting in the second or later column. 


* When there is a label: 
Written after the label, separated by one or more spaces or tabs. 


Examples: 


ADD RO,R1 ; An example with no label. 
LABEL1: ADD R1,R2 ; An example with a label. 
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CAUTION! 


Since white spaces and tabs are ASCII characters, each space or tab requires a byte of storage. 


(3) Coding of Operand 
The operand is written following the operation field, separated by one or more spaces or tabs. 


Examples: 


ADD RO,R1 ; The ADD instruction takes two operands. 
SHAL R1 ; The SHAL instruction takes one operand. 


(4) Coding of Comment 
The comment is written following a semicolon (;). 
The assembler regards all characters from the semicolon to the end of the line as the comment. 


Examples: 


ADD RO,R1 ; Adds RO to R1. 


14 HITACHI 


1.1.3 Coding of Source Statements across Multiple Lines 
A single source statement can be written across several lines in the following situations: 


* When the source statement is too long as a single statement. 


* When it is desirable to attach a comment to each operand. 
Write source statements across multiple lines using the following procedure. 


1. Insert a new line after a comma that separates operands. 
2. Insert a plus sign (+) in the first column of the new line. 


3. Continue writing the source statement following the plus sign. 


Spaces and tabs can be inserted following the plus sign. 


Examples 
.DATA.L H'FFFFOOOO, 
+ H'FFOOFFOO, 
+ H'! FFFFFFFF 


; Inthis example, a single source statement is written across three lines. 


A comment can be attached at the end of each line. 


Examples: 
.DATA.L H'FFFFOOOO, ; Initial value 1. 
+ H'FFOOFFOO, ; Initial value 2. 
+ H'FFFFFFFF ; Initial value 3. 


; In this example, a comment is attached to each operand. 
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1.2 Reserved Words 
Reserved words are names that the assembler reserves as symbols with special meanings. 


Register names, operators, and the location counter are used as reserved words. Reserved words 
are different depending on the CPU type. Refer to the programming manual of the CPU used, for 
details. 


Reserved words must not be used as symbols. 


* Register names: RO to R15, FRO to FR15, DRO to DR14 (only even values), XDO to XD14 
(only even values), FVO to FV12 (only multiples of four), RO.BANK to R7_BANK, SP, SR, 
GBR, VBR, MACH, MACL, PR, PC, SSR, SPC, FPUL, FPSCR, MOD, RE, RS, DSR, AO, 
A0G, Al, AlG, MO, M1, X0, X1, YO, Yl, XMTRX, DBR, SGR 

* Operators: STARTOF, SIZEOF, HIGH, LOW, HWORD, LWORD, $EVEN, $ODD, $EVEN2, 
$ODD2 


* Location counter ($) 


Note: R15 and SP indicate the same register. 


Reference: 
Operators — Programmer's Guide, 1.6.1, "Expression Elements" 
Location counter — Programmer's Guide, 1.5, "Location Counter" 
CPU type — Programmer's Guide, 5.2.1, "Target CPU Assembler Directive", .CPU 
— User's Guide, 1.3, "SHCPU Environment Variable" 
— User's Guide, 2.2.1, "Target CPU Command Line Option", -CPU 
Symbols — Programmer's Guide, 1.3, "Symbols" 


L3 Symbols 


1.3.1 Functions of Symbols 


Symbols are names defined by the programmer, and perform the following functions. 


e Address symbols .................: Express data storage and branch destination addresses. 
* Constant symbols...............5 Express constants. 

* Aliases of register names...... Express general registers and floating-point registers. 
* Section MAME sccumecscaimmnnanes Express section names. * 


Note: A section is a part of the program, and the linkage editor regards it as a unit of 
processing. 


The following shows examples of symbol usage. 
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Examples: 


BRA SUB1 ; BRA is a branch instruction. 
; SUB1 is the address symbol of the destination. 
SUB1: | 
MAX: . EQU 100 ; .EQU is an assembler directive that sets a value to a | 
; symbol. | 
MOV.B #MAX, RO ; MAX expresses the constant value 100. | 
MIN: .REG RO ; .REG is an assembler directive that defines a register 
; alias. 
MOV.B #100,MIN ; MIN is an alias for RO. 
.SECTION CD, CODE, ALIGN=4 | 
; .SECTION is an assembler directive that declares a section.) 
; CD is the name of the current section. 
| 
| 
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1.3.2. Coding of Symbols 
(1) Available Characters 
The following ASCII characters can be used. 


¢ Alphabetical uppercase and lowercase letters (A to Z, a to z) 
* Numbers (0 to 9) 

* Underscore (_) 

* Dollar sign ($) 


The assembler distinguishes uppercase letters from lowercase letters in symbols. 
(2) First Character in a Symbol 
The first character in a symbol must be one of the following. 


* Alphabetical uppercase and lowercase letters (A to Z, a to Z) 
* Underscore (_) 
* Dollar sign ($) 


CAUTION! 

The dollar sign character used alone is a reserved word that expresses the location counter. 
Reference: 

Reserved words — Programmer's Guide, 1.2, "Reserved Words" 

(3) Maximum Length of a Symbol 

A symbol may contain up to 251 characters. 

The assembler ignores any characters after the first 251. 

(4) Names that Cannot Be Used as Symbols 


Reserved words cannot be used as symbols. The following names must not be used because they 
are used as internal symbols by the assembler. 


_$$nnnnn (n is a number from 0 to 9.) 


Note: Internal symbols are necessary for assembler internal processing. Internal symbols are not 
output to assemble listings or object modules. 


18 HITACHI 


1.4 Constants 


1.4.1. Integer Constants 
Integer constants are expressed with a prefix that indicates the radix. 


The radix indicator prefix is a notation that indicates the radix of the constant. 


¢ Binary numbers .................. The radix indicator “B'” plus a binary constant. 

* Octal numbers ...............06 The radix indicator “Q'” plus an octal constant. 

* Decimal numbers ................ The radix indicator “D'” plus a decimal constant. 

¢ Hexadecimal numbers ......... The radix indicator “H'” plus a hexadecimal constant. 


The assembler does not distinguish uppercase letters from lowercase letters in the radix indicator. 
The radix indicator and the constant value must be written with no intervening space. 


Examples: 


| 
-DATA.B B'10001000 : 

.DATA.B Q'210 ; These source statements express the same 
| -_DATA.B D'136 ; numerical value. 

.DATA.B H'88 : 


The radix indicator can be omitted. Integer constants with no radix indicator are normally 
decimal constants, although the radix for such constants can be changed with the .RADIX 
assembler directive. 


Reference: 


Interpretation of integer constants without a radix specified 
— Programmer's Guide, 5.2.8, "Other Assembler Directives", .RADIX 


Supplement: 


"Q" is used instead of "O" to avoid confusion with the digit 0. 
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1.4.2. Character Constants 
Character constants are considered to be constants that represent ASCII codes. 


Character constants are written by enclosing up to four ASCII characters in double quotation 
marks. 


The following ASCII characters can be used in character constants. 


ASCII code H'09 (tab) 
H'20 (space) to H'7E (tilde) 


Examples: 
.DATA.L "ABC" ; This is the same as .DATA.L H'00414243. 
.DATA.W "AB" ; This is the same as .DATA.W H'4142. 
.DATA.B "A" ; This is the same as .DATA.B H'41. 


; The ASCII code for A is: H'41 
; The ASCII code for B is: H'42 
; The ASCII code for C is: H'43 


In addition, Japanese kana and kanji characters in shift JIS code or EUC code can be used. When 
using Japanese characters in shift JIS code or EUC code, be sure to specify the SJIS or EUC 
command line option, respectively. Note that the shift JIS code and EUC code cannot be used 
together in one source program. 


Use two double quotation marks in succession to indicate a single double quotation mark in a 
character constant. 


Example: 
-DATA.B «Rem ; This is a character constant consisting of a single | 
double quotation mark. | 
.DATA.L " QE" ; Japanese kanji characters. 
References: 


SJIS command line option 
— User's Guide, 2.2.7, "Japanese Character Command Line Options," —SJIS 
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EUC command line option 
— User's Guide, 2.2.7, "Japanese Character Command Line Options," -EUC 


1.4.3 Floating-Point Constants 


Floating-point constants can be specified as operands in assembler directives for reserving 
floating-point constants. 


Floating-Point Constant Representation: 
Floating-point constants can be represented in decimal and hexadecimal. 


* Decimal representation 


F'[{+}] igo [ti[{t}] x1] 


. ih 


PA 2 cahtocosacustinnnnceutetornnmonertes Indicates that the number is decimal. It cannot be omitted. 


[i+3] pe 
. 


"n" indicates the integer part in decimal. "m" indicates the 
fraction part in decimal. Either the integer part or the fraction 
part can be omitted. If the sign (+) is omitted, the assembler 
assumes it is positive. 


t scsvasiotenss sos venoeneasarivenonees Benes Indicates that the number 1s in either of the following precisions 
¢ S: Single precision 
¢ D: Double precision 
If omitted, the assembler assumes the operation size of the 
assembler directive. 


[ER eX acta hrseinraniswrewemons Indicates the exponent part in decimal. If omitted, the assembler 
assumes 0. If the sign (+) is omitted, the assembler assumes it is 
positive. 

Example: 


0.005 = H'3BA3D70A 


F'0.5S-2 = 0.5x107? 


F'.123D3 = 0.123x107= 123 H'405EC00000000000 


| 
I 
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¢ Hexadecimal representation 


H'xxxx[.t] 

TELS etciticich cba sarsacepsiaa Indicates that the number is hexadecimal. It cannot be omitted. 

2.0.0.0, See ee eee Indicates the bit pattern of the floating-point constant in hexadecimal. If 
the bit pattern is shorter than the specified data length, it is aligned to the 
right end of the reserved area and Os are added to the remaining bits in the 
reserved area. If the bit pattern is longer than the specified data length, the 
right-side bits of the bit pattern are allocated for the specified data length 
and the remaining bits of the bit pattern are ignored. 

aS tecshlacutiorecceeeapaacs Indicates that the number is in either of the following precisions 


¢ S: Single precision 

¢ D: Double precision 

If omitted, the assembler assumes the operation size of the assembler 
directive. 


This format directly specifies the bit pattern of the floating-point constant to represent data 
that is difficult to represent in decimal format, such as Os for the specified data length or 
infinity. 


Example: 
H'0123456789ABCDEF.S = H'89ABCDEF 
H'FFFF .D = H'OOOOOOOOQ0000FFFF 


Floating-Point Data Range: 
Table 1-1 lists the floating-point data types. 


Table 1-1 Floating-Point Data Types 


Data Type Description 

Normalized number The absolute value is between the underflow and overflow 
boundaries including the boundary values. 

Denormalized number The absolute value is between 0 and the underflow boundary. 

Zero The absolute value is 0. : 

Infinity The absolute value is larger than the overflow boundary. 

Not-a-Number (NAN) A value that is not a numerical value. Includes sNAN (signaling NAN) 


and qNAN (quiet NAN). 
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These data types are shown on the following number line. NAN cannot be shown on the number 
line because it is not handled as a numerical value. 


ao 
—ca |+ 


=— Negatve norm alzed nu rs a Zero a ae Posie normalized num ber ——# 
Negative denorm alzed number Positive denom alzednum ber 
Table 1-2 lists the numerical value ranges the assembler can use. 


Table 1-2 Data Types and Numerical Value Ranges (Absolute Value) 


Data Type Single Precision Double Precision 
Normalized number Maximum value 3.40 x 10°8 1.79 x 1090 
Minimum value 1.18 x 10738 2.23 x 107308 
Denormalized number Maximum value 1.17 x 10-8 2.22x 10-308 
Minimum value 1.40 x 10-45 4.94 x 10-324 


Floating-Point Data Format: 


The floating-point data format is shown below: 


Single Precison 
i — re 


s|_ eof FT 


HITACHI 23 


¢ Sign bit (S) 
Indicates the sign of a value. Positive and negative are represented by 0 and 1, respectively. 
¢ Exponent part (E) 


Indicates the exponent of a value. The actual exponent value is obtained by subtracting the bias 
value from the value specified in this exponent part. 


¢ Fraction part (F) 


Each bit has its own significance and corresponds to 27!, 2-2, ..., 2 from the start bit, 
respectively ("n" is the bit length of the fraction part). 


Table 1-3 shows the size of each parameter in data format. 


Table 1-3 Data Format Size 


Parameter Single Precision Double Precision 
Bit length 32 bits 64 bits 

Sign bit (S) 1 bit : 4 bit 

Exponent part (E) : 8 bits 11 bits 

Fraction part (F) 23 bits 52 bits 

Bias of exponent value 127 1023 


A floating-point number is represented using the symbols in table 1-3 as follows: 


. (1. F) | : Normalized number 
ald | {{a:# > Denormalzed number 


(1. F)=1+b0x2-!+b1 x 2% 400... +bn1 x27 
(0. F)=b0x 2-1 +b1 x 22 4.0... + bn-1 X27 


b: Bit location in the fraction part 
n: Bit length of the fraction part 
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Table 1-4 shows the floating-point representation for each data type. NAN cannot be represented 
because it is not handled as a numerical value. 


Table 1-4 Floating-Point Representation for Each Data Type 


Data Type Single Precision Double Precision 
Normalized number (—1)8 - 2&-127 - (4. F) (—1)® - 2E-1028 - (4, F) 
Denormalized number = (—1)8 - 2-126 - (0. F) (—1)8 - 27-1022 - (0. F) 

Zero (-1)§ - 0 (-1)$ - 0 

Infinity (-1)§ - (-1)§ - 

Not-a-Number (NAN) quiet NAN, signaling NAN quiet NAN, signaling NAN 


Valid Range for Floating-Point Constants: 


When converting floating-point constants used in assembler directives for reserving floating- 
point numbers into object codes, the assembler rounds them in the following two modes to set the 
valid range. 


* Round to Nearest even (RN) 


Rounds the least significant bit in the object code to its nearest absolute value. When two 
absolute values are at the same distance, rounds the least significant bit to become zero. 


* Round to Zero (RZ) 
Rounds the least significant bit in the object code to zero. 


Example: 


Object code of .FDATA.S F' 1S-1 


RN: H'3DCCCCCD 
RZ: H'3DCCCCCC 


Reference: 


Rounding mode setting 
— User's Guide, 2.2.10, "Floating-Point Data Command Line Options," -ROUND 
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Handling Denormalized Numbers: 


The assembler handles denormalized numbers differently depending on the CPU type. In a CPU 
that does not handle denormalized numbers, if a value in the denormalized number range is used, 
warning number 841 occurs and the object code is output as zero. 


In a CPU that handles denormalized numbers, if a value in the denormalized number range is 
used, warning number 842 occurs and the object code is output in denormalized numbers. 


How to handle denormalized numbers can be switched with the DENORMALIZE command line 
option. 


Examples: 


CPU not handling denormalized numbers: 


.FDATA.S F' 18-40 Warning 841, Object code H'00000000 


CPU handling denormalized numbers: 
.FDATA.S F' 18-40 Warning 842, Object code H'000116C2 


Reference: 


Denormalized numbers 
— User's Guide, 2.2.10, "Floating-Point Data Command Line Options," -DENORMALIZE 


1.4.4 Fixed-Point Constants 


Fixed-point constants can be specified as operands in the assembler directive for reserving fixed- 
point data. 


Fixed-Point Number Representation: 
Fixed-point numbers express real numbers ranging from —1.0 to 1.0 in decimal. 
Word size and longword size are available for fixed-point numbers. 
* Word-size fixed-point numbers 
Two-byte signed integers expressing real numbers ranging from —1.0 to 1.0. 


The real number expressed by 2-byte signed integer x (—32,768 < = x < = 32,767) is x/32768. 
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Example: 


Fixed-point number 


=1 0 
=0..5 
0.0 
0.5 
0) 


dive 


Word-size representation 
H'8000 


H'CO000 
H'0000 
H'4000 
H'7FFF 


¢ Longword-size fixed-point numbers 


Four-byte signed integers expressing real numbers ranging from —1.0 to 1.0. The real number 
expressed by 4-byte signed integer x (—2,147,483,648 <= x <= 2,147,483,647) is 


x/2147483648. 


Example: 


Fixed-point number 
=1.. 0 


=0..5 
0.0 
0.5 
1.0 


Longword-size representation 
H'80000000 


H'C0000000 
H'00000000 
H'40000000 
H'7FFFFFFP 
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Fixed-Point Data Format: 


The fixed-point data format consists of a sign bit and a 15-bit fraction part in word size, and a 
sign bit and a 31-bit fraction part in longword size. The decimal point is assumed to be fixed on 
the right of the sign bit. 


Word size 

1514 Oo 

PTTEEETTTTTTTTT] = Bena pe 
5: Sign bit 

Ss —<$< ——— - ——s F : Fraction part 


Longword size 


130 oO 


LEE LL COS 


5 eS SEF 


Sign bit (S) 
Indicates the sign of a value. Positive and negative are represented by 0 and 1, respectively. 
Fraction part (F) 


Each bit has its own significance and corresponds to 2-1, 2-2, ..., 23! from the start bit, 
respectively. 


Valid Range for Fixed-Point Numbers: 


In long-word size, 31 bits can represent nine digits of data in decimal, but the assembler handles 
ten digits in decimal as a valid number, rounds the 35th bit in RN (round to the nearest absolute 
value) mode, and uses the high-order 31 bits of the result as fixed-point data. 


Note: The actual fixed-point data range is —1.0 to 0.9999999999, but the assembler assumes 1.0 


as 0.9999999999 and represents it as H'7FFFFFFF. 
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1.5 Location Counter 


The location counter expresses the address (location) in memory where the corresponding object 
code (the result of converting executable instructions and data into code the microprocessor can 


regard) is stored. 


The value of the location counter is automatically adjusted according to the object code output. 


The value of the location counter can be changed intentionally using assembler directives. 


Examples: 


-ORG H'00001000 ; 


-DATA.W H'FF ; 


-DATA.W H'FO ; 


.DATA.W H'10 ; 


.ALIGN 4 ; 


, 


, 


-DATA.L H'FFFFFFFF Fi 


This assembler directive sets the location counter to 
H'00001000. 


The object code generated by this assembler directive has 
a length of 2 bytes. 
The location counter changes to H'00001002. 


The object code generated by this assembler directive has 
a length of 2 bytes. 
The location counter changes to H'00001004. 


The object code generated by this assembler directive has 
a length of 2 bytes. 
The location counter changes to H'00001006. 


The value of the location counter is corrected to be a multiple | 


of 4. 
The location counter changes to H'00001008. 


The object code generated by this assembler directive has 
a length of 4 bytes. 
The location counter changes to H'0000100C. 


; .ORG is an assembler directive that sets the value of the location counter. 

i ALIGN is an assembler directive that adjusts the value of the location counter. 
i .DATA is an assembler directive that reserves data in memory. 

i .W is a specifier that indicates that data is handled in word (2 bytes) size. 

i .L is a specifier that indicates that data is handled in longword (4 bytes) size. 
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References: 


Setting the value of the location counter 
— Programmer's Guide, 5.2.2, "Section and Location Counter Assembler Directives", .ORG 


Correcting the value of the location counter 
— Programmer's Guide, 5.2.2, "Section and Location Counter Assembler Directives", 
ALIGN 


The location counter is referenced using the dollar sign symbol. 


Examples: 


1 a 


LABEL1: .EQU $ ; This assembler directive sets the value of the | 
; location counter to the symbol LABEL1. 


; .EQU is an assembler directive that sets the value to a symbol. 
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1.6 Expressions 


Expressions are combinations of constants, symbols, and operators that derive a value, and are 
used as the operands of executable instructions and assembler directives. 


1.6.1 Elements of Expression 


An expression consists of terms, operators, and parentheses. 


(1) Terms 


The terms are the followings: 


¢ A constant 


¢ The location counter reference ($) 


*« A symbol (excluding aliases of the register name) 


¢ The result of a calculation specified by a combination of the above terms and an operator. 


An independent term is also a type of expression. 


(2) Operators 


Table 1-5 shows the operators supported by the assembler. 


Table 1-5 Operators 
Operator Type Operator Operation Coding 
Arithmetic operations + Unary plus + <term> 
~ Unary minus — <term> 
+ Addition <term1> + <term2> 
= Subtraction <term1> — <term2> 
+ Multiplication <term1> * <term2> 
Za Division <term1> / <term2> 
Logic operations = Unary negation ~ <term> 
& Logical AND <term1> & <term2> 
| Logical OR <term1> | <term2> 
eh Exclusive OR <term1> ~ <term2> 
Shift operations << Arithmetic left shift <term 1> << <term 2> 
>> Arithmetic right shift <term 1> >> <term 2> 
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Table 1-5 Operators (cont) 


Operator Type Operator Operation Coding 
Section set STARTOF _ Derives the starting address STARTOF <section name> 
operations* of a section set. —_ 
SIZEOF Derives the size of asection SIZEOF <section name> 
set in bytes. 
Even/odd operations $EVEN 1 when the value is a $EVEN <symbol> 
multiple of 2, and 0 
otherwise 
$0DD O when the value is a $ODD <symbol> 
multiple of 2, and 1 
otherwise 
$EVEN2 1 when the value is a $EVEN2 <symbol> 
multiple of 4, and 0 
otherwise 
$O0DD2 0 when the value is a $ODD2 <symbol> 
multiple of 4, and 1 
otherwise 
Extraction operations HIGH Extracts the high-order byte © HIGH <term> 
LOW Extracts the low-order byte LOW <term> 
HWORD Extracts the high-order HWORD <term> 
word 
LWORD Extracts the low-order word LWORD <term> 


Note: See the supplement below. 


Supplement: 


In this assembly language, programs are divided into units called section. Sections are the units 
in which linkage processing is performed. 


When there are multiple sections of the same type and same name within a given program, the 
linkage editor links them into a single "section set". 


Reference: 


Sections — Programmer's Guide, 2.1, "Sections" 


(3) Parentheses 


Parentheses modify the operation precedence. 


See the next section, section 1.6.2, "Operation Precedence", for a description of the use of 


parentheses. 
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1.6.2 Operation Precedence 


When multiple operations appear in a single expression, the order in which the processing is 
performed is determined by the operator precedence and by the use of parentheses. The assembler 
processes operations according to the following rules. 


<Rule 1> 

Processing starts from operations enclosed in parentheses. 

When there are multiple parentheses, processing starts with the operations surrounded by the 
innermost parentheses. 


<Rule 2> 
Processing starts with the operator with the highest precedence. 


<Rule 3> 
Processing proceeds in the direction of the operator association rule when operators have the 
same precedence. 


Table 1-6 shows the operator precedence and the association rule. 
Table 1-6 Operator Precedence and Association Rules 


Precedence Operator Association Rule 


1 (high) + — ~ STARTOF SIZEOF Operators are processed from right to left. 
$EVEN $ODD $EVEN2 $ODD2 
HIGH LOW HWORD LWORD* 


2 ef Operators are processed from left to right. 
3 + Operators are processed from left to right. 
* << >> Operators are processed from left to right. 
5 & Operators are processed from left to right. 
6 (low) ‘ie . Operators are processed from left to right. 


Note: The operators of precedence 1 (highest precedence) are for unary operation. 
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The figures below show examples of expressions. 


Example 1: 


d+f(e2e- C34 (4%#- 5595) 
(a) 
ib) 


(di) 


The assembler calculates this expression in the order (a) to (d). 


The result of (a) is —1 


The result of (b) is2 | The final result of this calculation is 1. 
The result of (c) is 0 


C) 
The result of (d) is 1 


Example 2: 


- H'FFFFFFFL + H'OO0000FO * H'O0000010 | H' O00000F0 « H' OO00FFFE 


(2) 
(2) 


The assembler calculates this expression in the order (a) to (e). 


The result of (a) is H'OOOOO00F 

The result of (b) is H'OOOOOFOO 

The result of (c) is H'OOOOOFOF |} The final result of this calculation is H'OOOOOFFF. 
The result of (d) is H'OOOOOOFO 

The result of (e) is H'OOOOOFFF 
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Example 3: 


-~- ~ H o000000F 
(ey 
ib) 
ie 
td) 


The assembler calculates this expression in the order (a) to (d). 


The result of (a) is H'FFFFFFFO 
The result of (b) is H'00000010 | the final result of this calculation is H'00000011. 
The result of (c) is H'FFFFFFEF 

The result of (d) is H'00000011 
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1.6.3 Detailed Description on Operation 


STARTOF Operation: Determines the start address of a section set after the specified sections 
are linked by the linkage editor. 


SIZEOF Operation: Determines the size of a section set after the specified section are linked by 
the linkage editor. 


Example: 
SPU SHL 
SE¢TION IWIT_RAI, DATS, ALTGH=4 
.RES .E H'100 
SECTION INIT_DATS DATS, ALIGH=4 
INITLEGH .DATA.L (STRRIOF ONIT_RSIN.......... aida a ON 


INIT_EYD .DATA.L (STBARIGF INIT_RSIN + (SL2BOF INIT_Ram ...; [2] 


SESTION IGT ook , &LoGH=4 


INITIAL: 
IY. L TATAL RS 
IpYy #0,R5 
IPY.L TATE1+4 Ro 
BRS LOOP 2 
IV. L Gr, kt 
sieecas or hitigizes the date ares. in section 
: HIT RAM to 0. 
S00 #4 ,R4 = 
LOE? : 
Imy.L Gh, kz 
Sti HO RF? Rk 
EF Looe 
RIS 
HOP 
TATAL: 
TATA .L NTT _END 
TATA .L INTT _BGH 
END 


(1) Determines the start address of section NIT_RAM. 
(2) Determines the end address of section INIT AM. 
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HIGH Operation: Extracts the high-order byte from the low-order two bytes of a 4-byte value. 


Before operation After operation 
a+ 25 16415 1645 
[ee | Pee | Woo | Woo | Ha] 
Example: 


LABEL .EQU  H'00007FFF 
.DATA HIGH LABEL ; Reserves integer data H'0000007F on memory. 


LOW Operation: Extracts the lowest-order one byte from a 4-byte value. 


Before operation Afer operation 


1615 1615 5 
a oe Pwo [Woo [ Woo | ma] 
HWORD Operation: Extracts the high-order two bytes from a 4-byte value. 


Beton operation ATer operation 


31 16415 i] 1 16415 o 
H'sasce eon! 
LWORD Operation: Extracts the low-order two bytes from a 4-byte value. 


Before operation ATer operation 


31 16415 O a i615 0 


ee ee 
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Even/Odd Operation: Determines if the value of the address symbol is a multiple of 2 or 4. 
Table 1-7 shows the even/odd operations. 


Table 1-7 Even/Odd Operations 


Operator Operation 

SEVEN 1 when the value is a multiple of 2, and 0 otherwise 

$ODD 0 when the value is a multiple of 2, and 1 otherwise 

$EVEN2 1 when the value is a multiple of 4, and 0 otherwise 

$ODD2 0 when the value is a multiple of 4, and 1 otherwise 
Example: 


To obtain the current program counter value using an $ODD2 operator. 


LAB: 
MOVA @(0,PC),RO 
ADD #-4+2*SODD2 LAB,RO ; $ODD2 gives 0 when LAB is 


; a multiple of 4, and gives 1 when 


; LAB is not a multiple of 4. 
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1.6.4 Notes on Expressions 
(1) Internal Processing 
The assembler regards expression values as 32-bit signed values. 


Example: 


~H'FO 
The assembler regards H'FO as H'000000F0. 
Therefore, the value of ~H'FO is H'FFFFFFOF. (Note that this is not H'OOOOOOOF.) 


(2) Arithmetic Operators 


Where values must be determined at assembly, the multiplication and division operators cannot 
take terms that contain relative values (values which are not determined until the end of the 
linkage process) as their operands. 


Example: 


.IMPORT SYM 
.DATA SYM/10 ; Correctly assembled. 
.ORG SYM/10 ; An error will occur. 


Also, a divisor of 0 cannot be used with the division operator. 
(3) Logic Operators 


The logic operators cannot take terms that contain relative values as their operands. 


Reference: 


Relative values — Programmer's Guide, 2.2, "Absolute and Relative Values". 
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1.7. Character Strings 
Character strings are sequences of character data. 


The following ASCII characters can be used in character strings. 


ASCII code H'09 (tab) 
H'20 (space) to H'7E (tilde) 


A single character in a character string has as its value the ASCII code for that character and is 
represented as a byte sized data object. In addition, Japanese kana and kanji characters in shift 
JIS code or EUC code can be used. When using Japanese characters in shift JIS code or EUC 
code, be sure to specify the SJIS or EUC command line option, respectively. If not specified, 
Japanese characters are handled as the Japanese code specified by the host machine. 


Character strings must be written enclosed in double quotation marks. 


Use two double quotation marks in succession to indicate a single double quotation mark in a 
character string. 


Examples: 
. SDATA "Hello!" ; This statement reserves the character string data 
; Hello! | 
.SDATA so" eee ee ; This statement reserves the character string data | 
; Ter ee 
.SDATA """Hello!"""  ; This statement reserves the character string data 
; "Hello!" 
; .SDATA is an assembler directive that reserves character string data in memory. 
Supplement: 


The difference between character constants and character strings is as follows. 
Character constants are numeric values. They have a data size of either 1 byte, 2 bytes, or 4 bytes. 


Character strings cannot be handled as numeric values. A character string has a data size 
between | byte and 255 bytes. 
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References: 


SJIS command line option 
— User's Guide, 2.2.7, "Japanese Character Command Line Options," —SJIS 


EUC command line option 
— User's Guide, 2.2.7, "Japanese Character Command Line Options," -EUC 
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1.8 Local Label 


1.8.1 Local Label Functions 


A local label is valid locally between address symbols. Since a local label does not conflict with 
the other labels outside its scope, the user does not have to consider other label names. A local 
label can be defined by writing in the label field in the same way as a normal address symbol, and 
can be referenced by an operand. 


An example of local label descriptions is shown below. 


Example: 
LABEL1: ; Local block 1 start 
20001: 
CMP/EQ R1,R2 
BT 20002 ; Branches to ?0002 of local block 1 
BRA ?0001 ; Branches to ?0001 of local block 1 
20002: 
LABEL2: ; Local block 2 start | 
20001: | 
CMP/GE R1,R2 
BT ?0002 ; Branches to ?0002 of local block 2 
BRA 20001 ; Branches to ?0001 of local block 2 
20002: 
LABEL3: ; Local block 3 start 
Note: 


A local label cannot be referenced during debugging. 
A local label cannot be specified as any of the following items: 


* Macro name 

¢ Section name 

¢ Object module name 

¢ Label in .ASSIGNA, .ASSIGNC, .EQU, .ASSIGN, .REG, or .DEFINE 
¢ Operand in .EXPORT, ..MPORT, or .GLOBAL 
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1.8.2 Description Method of Local Label 

First Character: 

A local label is a character string starting with a question mark (?). 

Usable Characters: 

The following ASCII characters can be used in a local label, except for the first character: 


* Alphabetical uppercase and lowercase letters (A to Z and a to z) 
* Numbers (0 to 9) 

¢ Underscore (_) 

* Dollar sign ($) 


The assembler distinguishes uppercase letters from lowercase ones in local labels. 
Maximum Length: 


The length of local label characters is 2 to 16 characters. If 17 or more characters are specified, 
the assembler will not recognize them as a local label. 


1.8.3. Scope of Local Labels 


The scope of a local label is called a local block. Local blocks are separated by address symbols, 
or by the SECTION directives. 


The local label defined within a local block can be referenced in that local block. 


A local label belonging to a local block is interpreted as being unique even if its spelling is the 
same as local labels in other local blocks; it does not cause an error. 


Note: 


The address symbols defined by the .EQU or .ASSIGN directive are not interpreted as delimiters 
for the local block. 
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Section 2 Basic Programming Knowledge 


2.1 Sections 


If source programs are compared to natural language writing, a section will correspond to a 
"chapter." The section is the processing unit used when the linkage editor links object modules. 


2.1.1 Section Types by Usage 


Sections are classified by usage into the following types. 


* Code section 
* Data section 
« Common section 
¢ Stack section 


¢ Dummy section 
(1) Code Section 
The following can be written in a code section: 


¢ Executable instructions 
¢ Extended instructions 


¢ Assembler directives that reserve initialized data. 


Examples: 

. SECTION CD, CODE, ALIGN=4 ; This assembler directive declares a 
; code section with the name CD. 

MOV.L X,R1 ; This is an executable instruction. 

MOV R1,R2 

ALIGN 4 

X: .DATA.L H'FFFFFFFF ; This assembler directive reserves 

; initialized data. 
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(2) Data Section 
The following can be written in a data section: 


¢ Assembler directives that reserve initialized data. 


¢ Assembler directives that reserve uninitialized data. 


SESTION Dt, Dar, eu n=4 ; This assembler directive declares 


adats section with the name DT2. 


Examples: 
| 
aa a a aaa aa aa aa a a aaa a a | 
i | 
SECTION Dt1, DATA, SLOGH=4 ; This assemblerdirective declares 
adats section with the name DT1. 1 
i] ! 
| | 
.DATS.W H' FFUO ; These assemblerdirectives reserve 1 | 
! | 
i .DATA.B H' FF ; Hiislized data. t | 
| 7 
H —_— : 
i | 
 saleaneaenaiateiatenatatatatenatetatanatatatatatatatatatatotarteretanatatatatatalatelanatatataiatataiaaiataaiataianenainanmaeenmesimammamamememamammmameanl 4 | 
1 J 
Dp a No NN a ae A a ee J | 
| 


.RES .W in ; These assembler directives reserve 
.RES .E io ; date aress that do not hase initial 
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(3) Common Section 


A common section is used as a section to hold data that is shared between files when a source 
program consists of multiple source files. 


The following can be written in a common section: 


¢« Assembler directives that reserve initialized data. 


¢« Assembler directives that reserve uninitialized data. 
Supplement: 


The linkage editor reserves common sections with the same name to the same area in memory. In 
the example shown in figure 2-1, the common section CM declared in file A and the common 
section CM declared in file B are reserved to the same area in memory. 


Frogran Memory 


Figure 2-1 Memory Reservation of Common Section 
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(4) Stack Section 


The section that the microprocessor uses as a stack area (an area for temporary data storage) is 
called the stack section. 


The following can be written in the stack section: 


¢« Assembler directives that reserve uninitialized data. 


Examples: 
.SECTION ST,STACK, ALIGN=4 ; This assembler directive declares a 
; stack section with the name ST. 
.RES.B 1024 ; This assembler directive reserves a 
; stack area of 1024 bytes. | 
STK: 


(5) Dummy Section 


A dummy section is a hypothetical section for representing data structures. The assembler does 
not output dummy sections to the object module. 


The following can be written in a dummy section: 


e Assembler directives that reserve uninitialized data. 


Examples: 
.SECTION DM, DUMMY ; This assembler directive declares 
; adummy section with the name DM. 
-RES.B 1 ; The assembler does not output the 
A: -RES.B 1 ; section DM to the object module. 
B RES.B 2 | 


Specific methods for specifying data structures are described in the supplement on the next page. 
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Supplement: 


As shown in figure 2-2, it is possible to access areas in memory by using address symbols from a 
dummy section. 


Dats stucture Memory 
Fe erence The $4an a 
pcan i iss none nnn nnn------- area 1 
1 1 
NS Sy a beet eea 4 Thesariolaeai_. 
symbol 4 tem pummy pus a 
AMIS: pe boannnnnn nanan nn - 1 P cecton The siariol area 1— Area 1 
symbole | fem B pus e 
fete 1 
Dita aaieearetan 2 
The ¢tan 
areaz 
The +n Oo eas 
pus 4% — 
The stan ol wea 2 Mere 
puse 


Figure 2-2 Data Structure Example Using Dummy Section 


Example: 


In the example above, assume that R1 holds the starting address of area 1 and R2 holds the 
starting address of area 2. 


MOV.L @(B,R1),RO ; Moves the contents of item B in area 1 to RO. 
MOV.L RO, @(B, R2) ; Moves the contents of RO to item B in area 2. 
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CAUTION! 


1. The following cannot be used in stack and dummy sections: 


a. Executable instructions 


Extended instructions 


c. Assembler directives that reserve initialized data 
(.DATA, .DATAB, .SDATA, .SDATAB, .SDATAC, .SDATAZ, .FDATA, .FDATAB, 


and .XDATA) 


2. When using a data or common section, be sure to keep in mind whether that section is 


reserved to ROM or RAM. 


2.1.2 Absolute Address Sections and Relative Address Sections 


A section can be classified as either an absolute address section or as a relative address section 
depending on whether absolute start addresses are given to the sections at assembly. 


(1) Absolute Address Section 


The memory locations of absolute address sections are specified in the source program, and 
cannot be changed by the linkage editor. In this assembly language, locations in an absolute 
address section are expressed as absolute addresses, which are addresses that express the actual 


position in memory. 


Examples: 


-SECTION ABS, DATA, LOCATE=H' 0000F000 


-DATA.W H!1111 


-DATA.W H!2222 ; 


, 


ABS is an absolute address section. 
The starting address of section ABS is 
the absolute address H'0000F000. 


The constant H'1111 is reserved at 
the absolute address H'0000FO000. 


The constant H'2222 is reserved at 
the absolute address H'0000F002. 
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(2) Relative Address Section 


The locations in memory of relative section are not specified in the source program, but rather 
are determined when the sections are linked by the linkage editor. In this assembly language, 
locations in a relative address section are expressed as relative addresses, which are addresses 
that express the position relative to the start of the section itself. 


Examples: 
.SECTION REL, DATA, ALIGN=4 ; REL is a relative address section. 
; The starting address of section REL is 
; determined after linkage. 
-DATA.W  H!'1111 ; The constant H'1111 is reserved at the | 
; relative address H'00000000. | 
.DATA.W H'2222 ; The constant H'2222 is reserved at the | 
; relative address H'00000002. 
Supplement: 


Dummy sections correspond neither to relative nor to absolute address sections. 
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Duk Absolute and Relative Values 


Absolute values are determined when assembly completes. Relative values are not determined 
until the linkage editor completes. 


2.2.1. Absolute Values 
The following are the absolute values handled by the assembler. 
(1) Constants 


* Integer constants 
¢ Character constants 


* Symbols that have a value that is one of the above (hereafter referred to as constant symbols). 
(2) Absolute Address Values 


¢ The location counter referenced in an absolute address section 
* The location counter referenced in a dummy section 


¢ Symbols that have a value that is one of the above (hereafter referred to as absolute address 
symbols). 


(3) Other Absolute Values 


Expressions whose value is determined when assembly completes. 


2.2.2 ‘Relative Values 
The following are the relative values handled by the assembler. 
(1) Relative Address Values 


¢ The location counter referenced in a relative address section 


* Symbols that have the above as a value (hereafter referred to as relative address symbols). 
(2) External Reference Values 

Symbols that reference another file (hereafter referred to as import symbols). 

(3) Other Relative Values 


Expressions whose value is not determined until the linkage editor completes. 
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2.3 Symbol Definition and Reference 


2.3.1 Symbol Definition 
(1) Normal Definition 


The normal method for defining a symbol is to write that symbol in the label field of a source 
statement. The value of that symbol will then be the value of the location counter at that point in 
the program. 


linkage completes, and its value is 
the shert address of the section 
3 plus 2. 


Examples: 
SECTION DT1, DATA ,LOCATE=H' ooOOTOOO ; This statement decares an | 
; absolute address section. 
| X1: -DATA.W #1111 ; The value of X1 becomes H'OO00F 000. | 
fm2:  .DATA.W "2222 ; The value of X2 becomes H'OOOOFOO2. | 
Joven en ceneeneneenneneenenetneneenennenetneneannateneenesteneatan 
beccnsneeececnncseeececcnasseeecncnasaeeeeecnnasaeesconasseeccnasaeeeecnnasseeeeecnnasa | 
SECTION DT2, DATA ,ALIGH=4 ; This statement dedares a relative 
| ; address section. 
TL: .DATA.W #1111 > The value of ¥'1 is determined when 
; linkage completes, and its value is 
; the stert address of the section. 
T: .DATA.W H' 2222 ; The value of ¥2 is determined when 
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(2) Definition by Assembler Directive 


Symbols can be defined by using assembler directives to set an arbitrary value or a special 


meaning. 
Examples: 
.SECTION DT1,DATA,ALIGN=4 _ ; DT1 is the section name. 
; Asection name is also a type of symbol 
; that expresses the start address of 
; asection. 
; However, the syntactic handling of address | 
; symbols and section names is different. 
xX: . EQU 100 ; The value of X is 100. 
; X cannot be redefined. 
Y: -ASSIGN 10 ; The value of Y is 10. 
; Y can be redefined. 
Z: . REG R1 ; Z becomes an alias of the general 


, 


register R1. 
Z cannot be redefined. 
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2.3.2 Symbol Reference 
There are three forms of symbol reference as follows: 


¢ Forward reference 
* Backward reference 


¢ External reference 


Supplement: 


Figure 2-3 shows the meaning of the terms forward and backward as used in this manual. 


Source program shart 


Source program end 


Figure 2-3 Meaning of the Terms Forward and Backward 


Figure 2-4 shows the meaning of the term external as used in this manual. 


Figure 2-4 Meaning of the Term External 
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(1) Forward Reference 


Forward reference means referencing a symbol that is defined forward from the point of 
reference. 


Examples: 
BRA FORWARD ; BRA is a branch instruction. 
; This is a forward reference to the symbol FORWARD. 
FORWARD: 


(2) Backward Reference 


Backward reference means referring to a symbol that is defined backward from the point of 
reference. 


Examples: 
BACK: 
BRA BACK ; BRA is a branch instruction. 
; This is a backward reference to the symbol BACK. 


(3) External Reference 
When a source program consists of multiple source files, a reference to a symbol defined in 


another file is called an external reference. External reference is described in the next 
section, 2.4, "Separate Assembly". 
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2.4 Separate Assembly 


2.4.1 Separate Assembly 


Separate assembly refers to the technique of creating a source program in multiple separate 
source files, and finally creating a single load module by linking together those source files' 
object modules using the linkage editor. 


The process of developing software often consists of repeatedly correcting and reassembling the 
program. In such cases, if the source program is partitioned, it will be only necessary to 
reassemble the source file that was changed. As a result, the time required to construct the 
complete program will be significantly reduced. 


Ifa sour programis cdlected Ha soure program is pa rifoned 
togethe rin 4 single dle... nto seven tiles... 


ar ee a a 


> Range of the prog ran thet rast 
be reaneerbled. 


Figure 2-5 Relationship between the Changed Range of the Source Program and the Range 
of the Program that must be Reassembled 
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The procedure involved in separate assembly consists of steps 1 to 4. 
1. Investigate methods for partitioning the program. 
Normally, programs are partitioned by function. 
Note that the memory reservation of the section must also be considered at this point. 
2. Divide the source program into separate files and edit those files accordingly. 
3. Assemble the individual files. 


4. Link the individual object modules into a single load module. 


2.4.2 Declaration of Export Symbols and Import Symbols 


When a source program consists of multiple files, referencing a symbol defined in one file from 
another file is called "external reference" or "import." When referencing a symbol externally, it is 
necessary to declare to the assembler that "this symbol is shared between multiple files" (this 
declaration is called "external definition" or "export"). 


(1) Export Symbol Declaration 


This declaration is used to declare that the definition of the symbol is valid in other files. 
-EXPORT or .GLOBAL directive is used to make this declaration. 
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(2) Import Symbol Declaration 


This declaration is used to declare that a symbol defined in another file is referenced. IMPORT 


or 


.GLOBAL directive is used to make this declaration. 


Examples: 
In this example the symbol MAX is defined in file A and referenced in file B. 
File A: 
-EXPORT MAX ; Declares MAX to be an export symbol. | 
MAX: .EQU 100 ; Defines MAX. | 
| 
File B: 
-IMPORT MAX ; Declares MAX to be an import symbol. 
MOV #MAX,RO ; References MAX. 
Reference: 


Symbol Export and Import 


— Programmer's Guide, 5.2.5, "Export and Import Assembler Directives", EXPORT, 


IMPORT, .GLOBAL 
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Section 3 Executable Instructions 


3.1 Overview of Executable Instructions 


The executable instructions are the instructions of microprocessor. The microprocessor interprets 
and executes the executable instructions in the object code stored in memory. 


An executable instruction source statement has the following basic form. 


[-opnbol +: ] Seaceaccio-[. operation aime>] baaddirecdiog aode-[, caddrecciog ace] ] fitconnents) 
SE eeeeeeeeeEEeEeEeEeEeEeEeEeEeEeE——E | 
ee ee = Oparand Oonrrand 


This section describes the mnemonic, operation size, and addressing mode. The other elements 
are described in detail in section 1, "Program Elements", in the Programmer's Guide. 


(1) Mnemonic 


The mnemonic expresses the executable instruction. Abbreviations that indicate the type of 
processing are provided as mnemonics for microprocessor instructions. 


The assembler does not distinguish uppercase and lowercase letters in mnemonics. 
(2) Operation Size 


The operation size is the unit for processing data. The operation sizes vary with the executable 
instruction. The assembler does not distinguish uppercase and lowercase letters in the operation 
size. 


Specifier Data Size 

B Byte 

WwW Word (2 bytes) - 
L Longword (4 bytes) 

Ss Single precision (4 bytes) 
D Double precision (8 bytes) 
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(3) Addressing Mode 


The addressing mode specifies the data area accessed, and the destination address. The 
addressing modes vary with the executable instruction. Table 3-1 shows the addressing modes. 


Table 3-1 Addressing Modes 


Addressing Mode Name 


Description 


Rn Register direct The contents of the specified register. 

@Rn Register indirect A memory location. The value in Rn gives the start 
address of the memory accessed. 

@Rn+ Register indirect with A memory location. The value in Rn (before being 


post-increment 


incremented"') gives the start address of the 
memory accessed. 

The microprocessor first uses the value in Rn for 
the memory reference, and increments Rn 
afterwards. 


@-Rn Register indirect with 
pre-decrement 


A memory location. The value in Rn (after being 
decremented*2) gives the start address of the 
memory accessed. 

The microprocessor first decrements Rn, and then 
uses that value for the memory reference. 


@(disp,Rn) Register indirect with 
displacement’3 


A memory location. The start address of the 


memory access is given by: the value of Rn plus 
the displacement (disp). 


The value of Rn is not changed. 


@(RO,Rn) Register indirect with A memory location. The start address of the 
index memory access is given by: the value of RO plus 
the value of Rn. 
The values of RO and Rn are not changed. 
@(disp,GBR) GBR indirect with A memory location. The start address of the 


displacement 


memory access is given by: the value of GBR plus 


the displacement (disp). 
The value of GBR is not changed. 


@(RO,GBR) GBR indirect with A memory location. The start address of the 
index memory access is given by: the value of GBR plus 
the value of RO. 
The values of GBR and RO are not changed. 
@(disp,PC) PC relative with A memory location. The start address of the 


displacement 


Notes 1 to 3: See next page. 
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memory access is given by: the value of the PC 


plus the displacement (disp). 


Table 3-1 


Addressing Modes (cont) 


Addressing Mode Name Description 


symbol 


PC relative specified | [When used as the operand of a branch 

with symbol instruction] 
The symbol directly indicates the destination 
address. 
The assembler derives a displacement (disp) from 
the symbol and the value of the PC, using the 
formula: disp = symbol — PC. 


[When used as the operand of a data move 
instruction] 

A memory location. The symbol indicates the start 
address of the memory accessed. 

The assembler derives a displacement (disp) from 
the symbol and the value of the PC, using the 


formula: disp = symbol — PC. 


[When used as the operand of an instruction that 
specifies the RS or RE register (L.DRS or LDRE 
instruction)] 

A memory location. The symbol indicates the start 
address"4 of the memory accessed. 

The assembler derives a displacement (disp) from 
the symbol and the value of the PC, using the 


formula: disp = symbol — PC. 


#imm 
Notes: 1. 


Immediate Indicates a constant. 


Increment 

The amount of the increment is 1 when the operation size is a byte, 2 when the 
operation size is a word (two bytes), and 4 when the operation size is a longword 
(four bytes). 

Decrement 

The amount of the decrement is 1 when the operation size is a byte, 2 when the 
operation size is a word, and 4 when the operation size is a longword. 
Displacement 

A displacement is the distance between two points. In this assembly language, the 
unit of displacement values is in bytes. 

Start address 

Refer to Programmer's Guide, 10.1, "Overview of Automatic Repeat Loop Generation 
Function.” 
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The values that can be used for the displacement vary with the addressing mode and the 
operation size. 


Table 3-2 Allowed Displacement Values 


Addressing Mode Displacement* 


@(disp,Rn) When the operation size is byte (B): 
H'00000000 to H'0000000F (0 to 15) 


When the operation size is word (W): 
H'00000000 to H'0000001E (0 to 30) 


When the operation size is longword (L): 
H'00000000 to H'0000003C = (0 to 60) 


@(disp,GBR) When the operation size is byte (B): 
H'00000000 to H'OO0000FF (0 to 255) 


When the operation size is word (W): 
H'00000000 to H'000001FE (0 to 510) 


When the operation size is longword (L): 
H'00000000 to H'000003FC (0 to 1020) 


@(disp,PC) [When used as an operand of a move instruction] 


When the operation size is word (W): 
H'00000000 to H'000001FE (0 to 510) 


When the operation size is longword (L): 
H'00000000 to H'000003FC (0 to 1020) 


[When used as an operand of an instruction that sets the RS or RE 
register (LDRS or LDRE)] 


H'FFFFFFOO to H'000000FE (—256 to 254) 
Note: Units are bytes, and numbers in parentheses are decimal. 
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Table 3-2 Allowed Displacement Values (cont) 


Addressing Mode Displacement* 
symbol [When used as a branch instruction operand] 


When used as an operand for a conditional branch instruction (BT, BF, 
BF/S, or BT/S): 

H'00000000 to H'O000000FF (0 to 255) 

H'FFFFFFOO to H'FFFFFFFF (—256 to —1) 
When used as an operand for an unconditional branch instruction 
(BRA or BSR) 

H'00000000 to H'OOO00FFF (0 to 4095) 

H'FFFFFOOO to H'FFFFFFFF (—4096 to —1) 
[When used as the operand of a data move instruction] 
When the operation size is word (W): 

H'00000000 to H'000001FE (0 to 510) 
When the operation size is longword (L): 

H'00000000 to H'000003FC (0 to 1020) 
[When used as an operand of an instruction that sets the RS or RE 
register (L.DRS or LDRE)] 

H'FFFFFFOO to H'OOQOO00FE (—256 to 254) 


Note: Units are bytes, and numbers in parentheses are decimal. 
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The values that can be used for immediate values vary with the executable instruction. 


Table 3-3 Allowed Immediate Values 


Executable Instruction Immediate Value 
TST, AND, OR, XOR H'00000000 to H'OOO000FF (0 to 255) 
MOV : leer to H'OOOO00FF = (0 to 255) 
H'FFFFFF80 to H'FFFFFFFF (—128 to —1)"1 
ADD, CMP/EQ i Eee to H'OOOOOOFF (0 to 255) 
H'FFFFFF80 to H'FFFFFFFF (—128 to —1)"1 
TRAPA H'00000000 to H'OO0000FF (0 to 255) 
SETRC H'00000001 to H'OOOO00FF (1 to 255)*2 
Notes: 1. Values in the range H'FFFFFF80 to H'FFFFFFFF can be written as positive decimal 
values. 


2. When zero is set as the immediate values of the SETRC instruction, warning number 
835 occurs and the object code is output as zero. In this case, the range to be 
repeated is executed once. 

When an import symbol is set as the immediate values of the SETRC instruction, the 
linkage editor checks the range from H'00000000 to H'000000FF (0 to 255). 


CAUTION! 


The assembler corrects the value of displacements under certain conditions. 


Condition Type of Correction 

When the operation size is a word and the —> | The lowest bit of the displacement is 

displacement is not a multiple of 2 — | discarded, resulting in the value being a | 
— | multiple of 2. | 


When the operation size is a longword and —> | The lower 2 bits of the displacement are 


the displacement is not a multiple of 4 — | discarded, resulting in the value being a 
— | multiple of 4. 

When the displacement of the branch —> | The lowest bit of the displacement is 

instruction is not a multiple of 2 — | discarded, resulting in the value being a 
— | multiple of 2. 


Be sure to take this correction into consideration when using operands of the mode @(disp,Rn), 
@(disp,GBR), and @(disp,PC). 


Example: MOV.L @(63,PC) ,RO 


The assembler corrects the 63 to be 60, and generates object code identical to that for the 
statement MOV.L @(60,PC),RO, and warning number 870 occurs. 
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5 Notes on Executable Instructions 


3.2.1 | Notes on the Operation Size 


The operation size that can be specified vary with the mnemonic and the addressing mode 


combination. 


SH-1 Executable Instruction and Operation Size Combinations: 


Table 3-4 shows the SH-1 allowable executable instruction and operation size combinations. 


Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 1) 


1. Data Move Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B Ww L Omitted 

MOV #imm,Rn O B “if 
MOV @(disp,PC),Rn x oO O i 

MOV symbol,Rn x O O L 

MOV Rn,Rm x x O L 

MOV Rn,@Rm O O O L 

MOV @Rn,Rm O O O L 

MOV Rn,@-Rm O O O L 

MOV @Rn+,Rm O O O L 

MOV RO,@(disp,Rn) O O O L 

MOV Rn,@(disp,Rm) x x O L. “2 
MOV @(disp,Rn),RO O O O L 

MOV @(disp,Rn),Rm x x O L *3 
MOV Rn,@(RO,Rm) O O O L 

MOV @(RO,Rn),Rm Oo oe & tL 7 
MOV RO,@(disp,GBR) O O O L 

MOV @(disp,GBR),RO O O O L 

MOVA #imm,RO x x L 

MOVA @(disp,PC),RO x x O L 

MOVA symbol,RO x x O iL 


Notes 1 to 3: See next page. 
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Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 1) (cont) 


1. Data Move Instructions Operation Sizes 
Default when 

Mnemonic Addressing Mode B W L Omitted 

MOVT Rn x x Oo L 

SWAP Rn,Rm O O x WwW 

XTRCT Rn,Rm x x O L. 

Symbol meanings: 

BRIT, RIM sn ciioscatmncrasee A general register (RO to R15) 

RO i sicsscmusnosiwebsannanins General register RO (when only RO can be specified) 

SIR sca oneutotoaeSSeenoaenaae Status register 

GBR veccescotisseeeecins Global base register 

WB Riesicsmnedeeccsateanccee Vector base register 

MACH, MACL ........ Multiplication and accumulation register 

PRR sxcsaseswecancexexeenacne Procedure register 

FO ee comucasitiadenactoaels Program counter 

LIT scenmeternevencaniavayns An immediate value 

CISD cssacssoaqasiiceandedets A displacement value 

SYVMDO |iscsusrsssnonseseve A symbol 

Bevcwesietirisinansavoungeastanis Byte 

WV cescoosireanenneninnsesmwest Word (2 bytes) 

L sicccimaneeseonntetcuedecee Longword (4 bytes) 

O zaecteemwveartniewen Valid specification 

Rt Kaisacimesiateuomesanmean Invalid specification: 


The assembler regards instructions with this combination as the 
specification being omitted. 
Si dediewoncabSdewbeoubeeatit The assembler regards them as extended instructions. 


Notes: 1. In size selection mode, the assembler selects the operation size according to the imm 
value. 


2. Inthis case, Rn must be one of R1 to R15. 
3. Inthis case, Rm must be one of R1 to R15. 


References: 


Extended instructions 
— Programmer's Guide, 9.2, "Extended Instructions Related to Automatic Literal Pool 
Generation" 


Size selection mode 
— Programmer's Guide, 9.3, "Size Mode for Automatic Literal Pool Generation" 
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Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 2) 


2. Arithmetic Operation Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B W L Omitted 
ADD Rn,Rm x x O L 

ADD #imm,Rn x x O L 
ADDC Rn,Rm x x O L 
ADDV Rn,Rm x x O L 
CMP/EQ #imm,RO x x O L 
CMP/EQ Rn,Rm x x a tL 
CMP/HS Rn,Rm x x O L 
CMP/GE Rn,Rm x s O L 
CMP/HI Rn,Rm x x O L 
CMP/GT Rn,Rm x x O L 
CMP/PZ Rn : x %*K oO oL 
CMP/PL Rn x ‘“ oOo iL 
CMP/STR Rn,Rm x x O L 

DIV1 Rn,Rm x x Oo iL 
DIVOS Rn,Rm x x O L 
DIVOU a (no operands) x x x — 
EXTS Rn,Rm 0 oOo. Ww 
EXTU Rn,Rm O O x W 

MAC @Rn+,@Rm+ x Oo x Ww 
MULS Rn,Rm x O O b " 
MULU Rn,Rm x O O L : 
NEG Rn,Rm x x O L 
NEGC Rn,Rm x x O Li 

SUB -Rn,Rm x “x oO oL 
SUBC Rn,Rm x x oO L 

SUBV Rn,Rm x x O L 


Note: The object code generated when W is specified is the same as that generated when L is 


specified. 
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Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 3) 


3. Logic Operation Instructions Operation Sizes 
Default when 
Mnemonic Addressing Mode B Ww L Omitted 
AND Rn,Rm x x @) L 
AND #imm,RO x O Lb 
AND #imm,@(RO,GBR) Oo x. x B 
NOT Rn,Rm x x oO L 
OR Rn,Rm x x oO L 
OR #imm,RO x x“ oO iL 
OR #imm,@(RO,GBR) O x x B - 
TAS @Rn O x x B 
TST Rn,Rm x “x oot : 
TST #imm,RO x x O L 
TST #imm,@(RO,GBR) — -~ oOo -~ x B : 
XOR Rn,Rm x x O 18 
XOR #imm,RO x x Oo L 
XOR #imm,@(RO,GBR) QO. x x B 
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Table 3-4 


4. Shift Instructions 


Operation Sizes 


SH-1 Executable Instruction and Operation Size Combinations (Part 4) 


Default when 


Mnemonic Addressing Mode B Ww L Omitted 
ROTL Rn x x O L 

ROTR Rn x» 6 - 
ROTCL Rn x x O L 
ROTCR Rn i x O L 

SHAL Rn x x O L 

SHAR Rn x « @ 

SHLL Rn ; x ™“K OL 

SHLR Rn x x O L 
SHLL2 Rn x “OL 
SHLR2 Rn * x O L 
SHLL8 Rn x x O L 
SHLR8& Rn x x O L 
SHLL16 Rn i x O L 
SHLR16 Rn : i -< oe tL 

Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 5) 


5. Branch Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B Ww L Omitted 
BF symbol x x x — 
BT symbol x x x — 
BRA symbol x x x — 
BSR symbol x x x — 
JMP @Rn x x x — 
JSR @Rn x x x — 
RTS (no operands) x x x — 
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Table 3-4 SH-1 Executable Instruction and Operation Size Combinations (Part 6) 


6. System Control Instructions Operation Sizes 
Default when 
Mnemonic Addressing Mode B WwW L Omitted 
CLRT (no operands) x x x — 
CLRMAC (no operands) x x x — 
LDC Rn,SR x x Oo UL 
LDC Rn,GBR x x O L 
LDC Rn,VBR x x Go - 
LDC @Rn+,SR x x oO UL 
LDC @Rn+,GBR x x Oo iL 
LDC @Rn+,VBR x x eo 
LDS Rn,MACH x x o - 
LDS Rn,MACL x x Oo UL 
LDS Rn,PR x x ym LL 
LDS @Rn+,MACH x K“K oO iL 
LDS @Rn+,MACL x x Oo OL 
LDS @Rn+,PR x x Oo iL 
NOP (no operands) x xX x — 
RTE (no operands) x x x —_— 
SETT (no operands) x x x — 
SLEEP (no operands) x x x — 
STC SR,Rn~ x ‘KX oO iL 
STC GBR,Rn x x oO L 
STC VBR,Rn x x Oo iL 
STC SR,@-Rn x x Oo iL 
STC GBR,@-Rn x x m - 
STC ~ VBR,@-Rn x x“ oO oL 
STS MACH,Rn x x O L 
STS MACL,Rn x x Oo OL 
STS ~ PR.Rn x x“ OL 
STS MACH,@-Rn x x © -L 
STS MACL,@-Rn — x x Oo iL 
STS PR,@-—Rn x x O L 
TRAPA #imm x x Oo UL 
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SH-2 Executable Instruction and Operation Size Combinations: 


Table 3-5 shows the executable instruction and operation size combinations for the SH-2 


instructions added to those of the SH-1. 


Table 3-5 SH-2 Executable Instruction and Operation Size Combinations (Part 1) 


1. Arithmetic Operation Instructions Operation Sizes 
Default when 
Mnemonic Addressing Mode B Ww L Omitted 
MAC @Rn+,@Rm+ x O O WwW 
MUL Rn,Rm x x O L 
DMULS Rn,Rm x x O L 
DMULU Rn,Rm x x Oo L 
DT Rn x x x _ 


Table 3-5 SH-2 Executable Instruction and Operation Size Combinations (Part 2) 


2. Branch Instructions Operation Sizes 

Default when 
Mnemonic Addressing Mode B Ww L Omitted 
BF/S symbol x x x — 
BT/S symbol x x x — 
BRAF Rn x x x — 
BSRF Rn x x x — 
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SH-2E Executable Instruction and Operation Size Combinations: 


Table 3-6 shows the executable instruction and operation size combinations for the SH-2E 
instructions added to those of the SH-2. 


Table 3-6 SH-2E Executable Instruction and Operation Size Combinations (Part 1) 


1. Data Move Instructions Operation Sizes 

Default when 
Mnemonic Addressing Mode B Ww L SS) Omitted 
FLDIO FRn x x x O Ss 
FLDI1 FRn x x x O Ss 
FMOV @Rm,FRn x x x O S) 
FMOV FRn,@Rm x x x O Ss 
FMOV @Rm+,FRn x x x O Ss 
FMOV FRn,@-Rm x x x O S 
FMOV @(RO,Rm),FRn x x x O S 
FMOV FRm,@(RO,Rm) x x x O Ss) 
FMOV FRm,FRn x x x O S 
Symbol meanings: 
FESO PRM sewieccccwosvecosopnose Floating-point register 
FRO vanecsivenescasimecesssnsnases FRO floating-point register (when only FRO can be specified) 
FP Ul pisccsaseccnmesiangesonuneies FPU low register 
PPSGR  seszicoseexecscxesasunse FPU status control register 
DSasvsaeapeedenestanessbaasantuenwoes Single precision (4 bytes) 
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Table 3-6 


2. Arithmetic Operation Instructions 


Operation Sizes 


SH-2E Executable Instruction and Operation Size Combinations (Part 2) 


Default when 


Mnemonic Addressing Mode B WwW L Ss Omitted 
FABS FRn * x x O S 

FADD FRm,FRn x x > O S) 
FCMP/EQ FRm,FRn 4 x x O S 
FCMP/GT FRm,FRn x 4 x O S 

FDIV FRm,FRn m x x O S 

FMAC FRO,FRm,FRn x x O S 

FMUL FRm,FRn » x x O s 

FNEG FRn x x x O S 

FSUB FRm,FRn x x x O Ss 

Table 3-6 SH-2E Executable Instruction and Operation Size Combinations (Part 3) 


3. System Control Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B W L Ss Omitted 
FLDS FRm,FPUL x x x O S 
FLOAT FPUL,FRn x x x O S 
FSTS FPUL,FRn x x x Oo Ss 
FTRC FRm,FPUL x x x O Ss 
LDS Rm,FPUL x x O x L 
LDS @Rm+,FPUL x x O x L 
LDS Rm,FPSCR ~ 4 ® oo « +£ 
LDS @Rm+,FPSCR x x O x L 
STS FPUL,Rn x x O x L 
STS FPUL,@-Rn x x O x L 
STS FPSCR,Rn x x O x I 
STS FPSCR,@-Rn x x O x L 
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SH-3 Executable Instruction and Operation Size Combinations: 


Table 3-7 shows the executable instruction and operation size combinations for the SH-3 
instructions added to those of the SH-2. 


Table 3-7 SH-3 Executable Instruction and Operation Size Combinations (Part 1) 


1. Data Move Instructions Operation Sizes 
Default when 
Mnemonic Addressing Mode B Ww L Omitted 
PREF @Rn x x x — 
Symbol meanings: 
RN_BANK ecscssensaeareowenis Bank general register 
SSR asscntswwancrqercexanwaseves Save status register 
SPC sccsiovionndsyvevgscenaeatiuns Save program counter 


Table 3-7 SH-3 Executable Instruction and Operation Size Combinations (Part 2) 


2. Shift Instructions Operation Sizes 

Default when 
Mnemonic Addressing Mode B WwW L Omitted 
SHAD Rn,Rm x x O L 
SHLD Rn,Rm x “ Oo ioL 
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Table 3-7 


3. System Control Instructions 


Operation Sizes 


SH-3 Executable Instruction and Operation Size Combinations (Part 3) 


Default when 


Mnemonic Addressing Mode B W L Omitted 
CLRS (no operands) x x x — 
SETS (no operands) x x x — 
LDC Rm,SSR x x O L 
LDC Rm,SPC x x O L 
LDC Rm,Rn_BANK x x O i 
LDC @Rm+,SSR x x O L 
LDC @Rm+,SPC x x O L 
LDC @Rm+,Rn_BANK x x O L 
STC SSR,Rn x x O L 
STC SPC,Rn x x O L 
STC Rm_BANK,Rn x “x oOo iL 
STC SSR,@-Rn x x O ji. 
STC SPC,@-Rn x x O L 
STC Rm_BANK,@-Rn 4 x O i 
LDTLB (no operands) x x x a= 
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SH-3E Executable Instruction and Operation Size Combinations: 


Table 3-8 shows the executable instruction and operation size combinations for the SH-3E 
instructions added to those of the SH-3. 


Table 3-8 SH-3E Executable Instruction and Operation Size Combinations (Part 1) 


1. Data Move Instructions Operation Sizes 

Default when 
Mnemonic Addressing Mode B W L Ss Omitted 
FLDIO FRn x x x Oo S 
FLDI1 FRn x x x O S 
FMOV @Rm,FRn x x % O Ss 
FMOV FRm,@Rn x x x O Ss 
FMOV @Rm+,FRn x x x O Ss 
FMOV FRm,@-Rn x x x O S) 
FMOV @(RO,Rm),FRn x x x e) S) 
FMOV FRn,@(RO,Rn) x x x o. 6s 
FMOV FRm,FRn x x x O Ss 
Symbol meanings: 
FRM, FRI.....000o0crceesooes Floating-point register 
FRO ccteavsevemstmerneniocionncss FRO floating-point register (when only FRO can be specified) 
PUL visa -nspicecncrepreauvncsaces FPU low register 
FRSGR seccomransuvensexneseas FPU status control register 
S icasscammencentnnea meres Single precision (4 bytes) 
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Table 3-8 SH-3E Executable Instruction and Operation Size Combinations (Part 2) 


2. Arithmetic Operation Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B W L ) Omitted 
FABS FRn x x x O S 

FADD FRm,FRn x x x O S 
FCMP/EQ FRm,FRn x x x O S 
FCMP/GT FRm,FRn x x % O S) 

FDIV FRm,FRn x x m O S 

FMAC FRO,FRm,FRn x x x O S 

FMUL FRm,FRn x ™%“ «x Oo Ss 

FNEG FRn x x x O S 
FSQRT FRn x x x O Ss 

FSUB FRm,FRn x % x O S 

Table 3-8 SH-3E Executable Instruction and Operation Size Combinations (Part 3) 


3. System Control Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B WwW L Ss Omitted 
FLDS FRm,FPUL x x x O S 
FLOAT FPUL,FRn x x x O S 
FSTS FPUL,FRn x x x O S 
FTRC FRm,FPUL x x x O S 
LDS Rm,FPUL x x O x L 
LDS @Rm+,FPUL x x O * L 
LDS Rm,FPSCR x x e) x L 
LDS @Rm+,FPSCR x x oO x L 
STS FPUL,Rn x x O x L 
STS FPUL,@-—Rn x x O x L 
STS FPSCR,Rn x x O x i. 
STS FPSCR,@-Rn x x O x L 
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SH-4 Executable Instruction and Operation Size Combinations: 


Table 3-9 shows the executable instruction and operation size combinations for the SH-4 
instructions added to those of the SH-3E. 


Table 3-9 SH-4 Executable Instruction and Operation Size Combinations (Part 1) 


1. Data Move Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B Ww L Ss D Omitted 
FMOV DRm,DRn x x x x O D 
FMOV DRm,@Rn x x x x O D 
FMOV DRm,@-Rn x x x x O D 
FMOV DRm,@(RO0,Rn) x x x x O D 
FMOV @Rm,DRn x x x x O D 
FMOV @Rm+,DRn x x x x Oo 80D 
FMOV @(RO,Rm),DRn x x x x O D 
FMOV DRm,XDn x sy x x O D 
FMOV XDm,DRn x x x x Oo D 
FMOV XDm,XDn x ‘%‘K. x“X x OD 
FMOV XDm,@Rn x x x x Oo. 8606©D 
FMOV XDm,@-Rn x x x x O D 
FMOV XDm,@(RO,Rn) x x x x O D 
FMOV @Rm,XDn x x x x O D 
FMOV @Rm+,XDn x x x x O D 
FMOV @(RO,Rm),XDn x x x x (@) D 
Symbol meanings: 

DRm,DRnh.............64. Double-precision floating-point register 

ADM XD vssecscctencwons Extended double-precision floating-point register 

PMN PVM ascaisanameenseeresieoce Single-precision floating-point vector register 

RMIT RX vets stcateisnase oanteeese Single-precision floating-point extended register matrix 
DB Ri scsneisnsnsesteancecncces Debug vector base register 

9S ORiieecotonndrentematean Save general register 15 

LD) .zcecheesanatensinsanaacaaedey Double precision (8 bytes) 
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Table 3-9 SH-4 Executable Instruction and Operation Size Combinations (Part 2) 


2. Arithmetic Operation Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B WwW L Ss D Omitted 
FABS DRn x x x x O D 

FADD DRm,DRn x x x x Oo D 
FCMP/EQ DRm,DRn x x x x O D 
FCMP/GT  DRm,DRn x x x x O D 

FDIV DRm,DRn x x x d< O D 

FIPR FVm,FVn x x x O i S) 

FMUL DRm,DRn x x x x O D 

FNEG DRn x x x x O D 
FSQRT DRn x“ “x x“ Oo OD 

FSUB DRm,DRn x x x x O D 

FTRV XMTRX,FVn x “x x Oo. 8s 

Table 3-9 SH-4 Executable Instruction and Operation Size Combinations (Part 3) 


3. System Control Instructions 


Operation Sizes 


Default when 


Mnemonic Addressing Mode B Ww L Ss D Omitted 
FCNVDS DRm,FPUL x x x x O D 
FCNVSD FPUL,DRn x x x x O D 
FLOAT FPUL,DRn x ‘VK x“ “x OD 
FRCHG (no operands) x x x x x — 
FSCHG (no operands) x x x x x — 
FTRC DRm,FPUL x ™%‘K x %*x QO OD 
LBC Rm,DBR x %. oO -K. KL 
LDC @Rm+,DBR x x O x x L 
OCBI @Rn x x x x O — 
OCBP @Rn x x x x oo — 
OCBWB @Rn x x x x O — 
STC DBR,Rn x x O x x L 
STC DBR,@-Rn x x Oo x. x L 
STC SGR,Rn x x O x x L 
STC SGR,@-Rn x x Oo x x L 
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SH-DSP, SH3-DSP Executable Instruction and Operation Size Combinations: 


Table 3-10 shows the executable instruction and operation size combinations for the SH-DSP and 
SH3-DSP instructions added to those of the SH-2 and SH-3, respectively. 


Table 3-10 SH-DSP, SH3-DSP Executable Instruction and Operation Size Combinations 


(Part 1) 

1. Repeat Control Instructions Operation Sizes 
Default when 

Mnemonic Addressing Mode B WwW L Omitted 
LDRS @(disp,PC) x x O L 
LDRS symbol x x O i. 
LDRE @(disp,PC) on x O i. 
LDRE symbol x x O L 
SETRC Rn x x x — 
SETRC #imm x x x —_— 
Symbol meanings: 
NOD) cieisecstusvonorateanavuerd Modulo register 
RS sssecssezemecansseaneenewsoeres Repeat start register 
TR Bincsapsincnoinederaamainonswseseee Repeat end register 
DSR ectncssctasteeus etersceene DSP status register 
AO esenesssensacavesnustaansncewners DSP data register (AO, XO, X1, YO, or Y1 can be specified.) 
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Table 3-10 SH-DSP, SH3-DSP Executable Instruction and Operation Size Combinations 


(Part 2) 
2. System Control Instructions Operation Sizes 
Default when 

Mnemonic Addressing Mode B WwW L Omitted 
LDC Rn,MOD x x O L 
LDC Rn,RS x x O L 
LDC Rn,RE x x O L 
LDC @Rn+,MOD x x O L 
LDC @Rn+,RS x x ) L 
LDC @Rn+,RE x x O L. 
LDS Rn,DSR x x O [. 
LDS Rn,AO x x O i. 
LDS @Rn+,DSR x x O L 
LDS @Rn+,A0 x x O L 
STC MOD,Rn x * O L 
STC RS,Rn x x O L 
STC RE,Rn x x O L 
STC MOD,@-Rn x x O L 
STC RS,@-Rn x x O L 
STC RE,@-Rn x x O L 
STS DSR,Rn x x O L 
STS AO,Rn x x O L 
STS DSR,@-Rn x x O L 
STS A0,@-Rn x x O L 


3.2.2. Notes on Delayed Branch Instructions 


The unconditional branch instructions are delayed branch instructions. The microprocessors 
execute the delay slot instruction (the instruction directly following a branch instruction in 
memory) before executing the delayed branch instruction. 


If an instruction inappropriate for a delay slot is specified, the assembler issues error number 150 
or 151. 


Table 3-11 shows the relationship between the delayed branch instructions and the delay slot 
instructions. 
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Table 3-11 Relationship between Delayed Branch Instructions and Delay Slot Instructions 


Delayed Branch 


Delay Slot BF/S BT/S BRAF BSRF BRA BSR JMP JSR RTS RTE 
BF x x x x x x x x 
BT x x x x x x x x x x 
BF/S x x x x x x x x x x 
BT/S ; x x x x x x x x x x 
BRAF x x x x x x x x x x 
BSRF - x x x x x x x x x x 
BRA ; x x x x x x x x x x 
BSR : x x x x x x x x x x 
JMP - - x x x x x x x x x x 
JSR x x x x x x x x x x 
RTS x D4 x x x x x x x x 
RTE 4 x x x % x x x x x 
TRAPA _ x x x x x x x x x x 
LDC 7 Rn,SR #4 #4 *4 4 a *4 “4 “4 “4 | 
@Rn+,SR “4 m4 4 *4 4 #4 4 ie a | 
MOV @(disp,PC),Rn “2 #2 #9 "2 #2 72 2 *2 42 i) 
symbol,Rn ey) #2 oe x “2 aD x x x x 
MOVA @(disp,PC),RO 2 2 *2 “2 7 a a i 
symbol,RO *2 49 4 x #2 - x x x x 
Extended ~ MOV.L #imm,Rn x se x x x x x x x x 
instructions MOV.W #imm,Rn x x x x x x x x x x 
MOVA #imm,RO x x x x x x x x x x 
Any other instruction O O O O O O Oo O O O 
Symbol meanings: 
O axis: Normal, i.e., the assembler generates the specified object code. 


Ml ewsaiz Error 150 or 151 
The instruction specified is inappropriate as a delay slot instruction. 
The assembler generates object code with a NOP instruction (H'0009). 
Notes: 1. Operates normally when the CPU type is SH-1, SH-2, SH-2E, or SH-DSP. 
Any other CPU type will cause error 150 or 151 to occur. 
2. When the CPU type is SH-4, error 150 or 151 occurs. 
Any other CPU type will cause warning 871 to occur. 


Note on the value of PC: PC = <destination address for the delayed branch 
instruction> + 2 
The assembler generates the specified object code. 
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CAUTION! 


If the delayed branch instruction and the delay slot instruction are coded in different sections, the 
assembler does not check the validity of the delay slot instruction. 


Reference: 


Extended Instructions 
— Programmer's Guide, 9.2, "Extended Instructions Related to Automatic Literal Pool 
Generation" 


3.2.3 Notes on Address Calculations 


When the operand addressing mode is PC relative with displacement, i.e., @(disp,PC), the value 
of PC must be taken into account in coding. The value of PC can vary depending on certain 
conditions. 


(1) Normal Case 


The value of PC is the first address in the currently executing instruction plus 4 bytes. 


Examples: (Consider the state when a MOV instruction is being executed at absolute address 
H'00001000.) 


Absolute addresses 
H'00001000 


PO | H'00001004 


disp = 9 bites 


H'0000100¢ 


2 bytes 


Figure 3-1 Address Calculation Example (Normal Case) 
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(2) During the Delay Slot Instruction 


The value of PC is destination address for the delayed branch instruction plus 2 bytes. 


Examples: (Consider the state when a MOV instruction is being executed at absolute address 
H'00001000.) 


Absolute addresses 


HOMO |: 


Li =H'00001006 


PC 


H'0000 1008 


H00001010 


2 bites 


Figure 3-2 Address Calculation Example (When the Value of PC Differs Due to a Branch) 


Supplement: 


When the operand is the PC relative specified with the symbol, the assembler derives the 
displacement taking account of the value of PC when generating the object code. 
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(3) During the Execution of Either a MOV.L @(disp,PC),Rn or a MOVA @(disp,PC),RO 


When the value of PC is not a multiple of 4, microprocessors correct the value by discarding the 
lower 2 bits when calculating addresses. 


Examples: 1. When the microprocessor corrects the value of PC 
(Consider the state when a MOV instruction is being executed at address 
H'00001002.) 


Address 
H'o0001002 |... 
H'oo001004 


disp = 8 bytes 


The value of the PC 
is corrected to be 
amukiple of 4. 


H'0000 100¢ 


2 bytes 


Figure 3-3 Address Calculation Example (When Microprocessor Corrects the Value of PC) 


2. When the microprocessor does not correct the value of PC 
(Consider the state when a MOV instruction is being executed at address 
H'00001000.) 


Memory, 


Address 
H'00001000 |. 


7 MO¥L @[8,PC),RO = 


Po (H'0000 1004 


disp = 8 bytes 


nea 

[=e Le 
Areato be accessed 

_iaa ee 


et 
2 bytes | 


The value of the PC 
is not changed. 


H'0000 1000 


Figure 3-4 Address Calculation Example (When Microprocessor Does Not Correct 
the Value of PC) 
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Supplement: 


When the operand is the PC relative specified with the symbol, the assembler derives the 
displacement taking account of the value of PC when generating the object code. 
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Section 4 DSP Instructions 


4.1 Program Contents 


4.1.1 Source Statements 


The SH-DSP instructions are classified into two types: executable instructions and DSP 
instructions. The DSP instructions manipulate DSP registers. The instruction set and description 
format of DSP instructions are different from those of the executable instructions. For the DSP 
instructions, many operations can be included in one statement. The DSP instruction operation is 
as follows: 


1. DSP operation: Specifies operations between DSP registers. 


PABS, PADD, PADDC, PAND, PCLR, PCMP, PCOPY, PDEC, PDMSB, PINC, PLDS, 
PMULS, PNEG, POR, PRND, PSHA, PSHL, PSTS, PSUB, PSUBC, PXOR 


2. X data transfer operation: Specifies data transfer between a DSP register and X data memory. 
MOVX, NOPX 

3. Y data transfer operation: Specifies data transfer between a DSP register and Y data memory. 
MOVY, NOPY 

4. Single data transfer operation: Specifies data transfer between a DSP register and memory. 
MOVS 

Reference: 


Executable instructions 
— Programmer's Guide, 3, "Executable Instructions" 
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4.1.2. Parallel Operation Instructions 


Parallel operation instructions specify DSP operations as well as data transfer between a DSP 
register and X or Y data memory at the same time. The instruction size is 32 bits. The description 
format is as follows: 


[<label>] [ <DSP operation part>][ <data transfer part>] [<comment>] 


DSP Operation Part Description Format: 
[<condition> ]<DSP operation> <operand>[ <DSP operation> <operand>] 
* Condition: Specifies how parallel operation instruction is executed as follows: 


DCT: The instruction is executed when the DC bit is 1. 
DCF: The instruction is executed when the DC bit is 0. 


¢ DSP operation: Specifies DSP operation. 
PADD and PMULS, and PSUB and PMULS can be specified in combination. 
Data Transfer Part Description Format: 


{<X data transfer operation>[ <operand>] ] 
[ <Y¥ data transfer operation>[ <operand>] ] 


Be sure to specify X data transfer and Y data transfer in this order. Inputting an instruction is not 
required when the data move instruction is NOPX or NOPY. 


Example: 


LABED1: PLOO 20,H0,20 PHULE XO, 20,40 HoT. Gat xO Hors. Gast x0: ome Instruction 
Label Dé Poperaten pan Dats tant pari Comment 


OT PING 1,81 HOW.” Gad, xO HoTy.e Gad, 20 
DEP operaton pant Dat fanter pari 


ROHR x1, HO HOTx.T Oma, x0 ix Homory transter is omitted 
DéPoperaton pan Dats tamer pant Comment 
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4.1.3 Data Move Instructions 


Two types of data move instructions are available: combination of X data memory transfer and Y 
data memory transfer, and single data transfer. The description formats are as follows: 


Combination of X Data Memory Move and Y Data Memory Move Instructions: 


[<label>] [ <X data transfer operation>[ <operand>] ] 
[ <¥ data transfer operation>[ <operand>]] [<comment>] 


Be sure to specify X data memory transfer and Y data memory transfer in this order. Inputting an 
instruction is not required when the data move instruction is NOPX or NOPY. Note that both X 
data memory and Y data memory cannot be omitted, unlike the parallel operation instruction. 


Example: 


LABEL2: MOVX.W @R4,X0 ; Data move instruction 
(Y data memory transfer is omitted) 


MOVX.W @R4,X0 MOVY.W @R6+, YO 


Single Data Move Instruction: 


[<label>] [ <single data transfer operation> <operand>] [<comment>] 


Specifies the MOVS instruction. 


Example: 


LABEL3 : MOVS.W @-R2,A0 ; Single data transfer 
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4.1.4 Coding of Source Statements Across Multiple Lines 


For the DSP instructions, many operations can be included in one statement, and therefore, source 
statements become long and complicated. To make programs easy to read, source statements for 
DSP instructions can be written across multiple lines by separating between an operand and an 
operation, in addition to separating at a comma between operands. 


Write source statements across multiple lines using the following procedure. 


1. Insert a new line between an operand and an operation. 
2. Insert a plus sign (+) in the first column of the new line. 
3. Continue writing the source statement following the plus sign. 


Spaces and tabs can be inserted following the plus sign. 


Example: 


PADD AO,MO,X0 


+ PMULS Al1,Y1,M0O 
+ MOVX @R4,x0 
+ MOVY @R6,Y1 


; Asingle source statement is written across four lines. 
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4.2 DSP Instructions 


4.2.1. DSP Operation Instructions 
Table 4-1 lists DSP instructions in mnemonic. 
Table 4-1. DSP Instructions in Mnemonic 


Instruction Name Mnemonic 


DSP arithmetic operation instructions | PADD, PSUB, PCOPY, PDMSB, PINC, PNEG, PMULS, 
PADDC, PSUBC, PCMP, PDEC, PABS, PRND, PCLR, 


PLDS, PSTS 
DSP logic operation instructions POR, PAND, PXOR 
DSP shift operation instructions PSHA, PSHL 


Operation Size: 

For the DSP operation instructions, operation size cannot be specified. 
Addressing Mode: 

Table 4-2 lists addressing modes for the DSP operation instructions. 


Table 4-2. Addressing Modes for DSP Operation Instructions 


Addressing Mode Description Format 
DSP register direct Dp (DSP register name) 
Immediate data #imm 
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¢ DSP register direct 


Table 4-3 lists registers that can be specified in DSP register direct addressing mode. For Sx, 
Sy, Dz, Du, Se, Sf, and Dg, refer to table 4-5, DSP Operation Instructions. 


Table 4-3 Registers that Can Be Specified in DSP Register Direct Addressing Mode 


DSP Register 


AO Al MO M1 X0 x1 Yo Y1 
Dp Sx Yes Yes Yes Yes 

Sy Yes Yes Yes Yes 
Dz Yes Yes Yes Yes Yes Yes Yes Yes 
Du Yes Yes Yes Yes 

Se Yes Yes Yes Yes 

Sf Yes Yes Yes Yes 
Dg Yes Yes Yes Yes 


¢ Immediate data 


Immediate data can be specified for the first operand of the PSHA and PSHL instructions. The 
following items can be specified: 


— Value type 
Constants, symbols, or expressions can be specified. 


— Symbol types 
Symbols including relative and import symbols can be specified as immediate data.* 


— Value range 
Table 4-4 lists the specifiable value ranges. 


Table 4-4 Ranges of Immediate Data 


Instruction Range 
PSHA instruction H'FFFFFFEO to H'00000020 (—32 to 32) 
PSHL instruction H'FFFFFFFO to H'00000010 (—16 to 16) 


Note: When a relative symbol or import symbol is specified as immediate data, the linkage 
editor checks the value in the rage from H'FFFFFFCO to H'0000003F (—64 to 63). 
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Combination of Multiple DSP Operation Instructions: 


The PADD instruction and the PMULS instruction, or the PSUB instruction and the PMULS 
instruction can be specified in combination. Each of these two combinations is basically one DSP 
instruction. The PADD (or PSUB) operand and a PMULS operand are separately described so 
that programs can be read easily. 


Example: 


PADD AO,MO,AO PMULS X0,Y0,MO NOPX MOVY.W @R6+, YO 
PSUB Al1,M1,Al PMULS X1,Y1,M1 MOVX @R4+,X0 NOPY 


Note: Warning 701 is displayed if the same register is specified as the destination registers 
when multiple DSP operation instructions are specified in combination. 


Example: 


PADD AQ,MO,AO PMULS X0,Y0,A0 -» Warning 701 


Conditional DSP Operation Instructions: 


Conditional DSP operation instructions specify if the program is executed according to the DC bit 
of the DSR register. 


DCT: When the DC bit is 1, the instruction is executed. 
DCF: When the DC bit is 0, the instruction is executed. 


Conditional DSP operation instructions are the following: 


PADD, PAND, PCLR, PCOPY, PDEC, PDMSB, PINC, PLDS, PNEG, POR, PSHA, PSHL, 
PSTS, PSUB, PXOR 


DSP Operation Instruction List: 


Table 4-5 lists DSP operation instructions. For the registers that can be specified as Sx, Sy, Dz, 
Du, Se, Sf, and Dg, refer to table 4-3, Registers that Can Be Specified in DSP Register Direct 
Addressing Mode. 
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Table 4-5 DSP Operation Instructions 


Table 4-5 DSP Operation Instructions (cont) 


Mnemonic Addressing Mode Mnemonic 
PSTS MACL, Dz 


Mnemonic Addressing Mode Mnemonic Addressing Mode 
PABS Sx, Dz 

PABS Sx, Dz 

PADD | "Sx, Sy, Dz ; : a 
PADD Sx, Sy, Du PMULS Se, Sf, Dg 

PADDC Sx, Sy, Dz 

PAND Sx, Sy, Dz 

PCLR Dz 

PCMP  =——“‘is—SCSSx, Sy Oo - are 
PCOPY Sx, Dz 

PCOPY Sy, Dz 

PDEC Sx, Dz 

PDEC Sy, Dz 

PDMSB Sx,Dz — —_ 
PDMSB Sy, Dz 

PINC Sx, Dz 

PINC Sy, Dz 

PLDS Dz, MACH 

PLDS Dz, MACL SO oO 
PMULS Se, Sf, Dg 

PNEG Sx, Dz 

PNEG Sy, Dz 

POR Sx, Sy, Dz 

PRND Sx, Dz 

PRND Sy, Dz 

PSHA #imm, Dz 

PSHA Sx, Sy, Dz 

PSHL #imm, Dz 

PSHL Sx, Sy, Dz 

PSTS MACH, Dz 


Addressing Mode 
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PSUB Sx, Sy, Dz 


PSUB Sx, Sy, Du PMULS Se, Sf, Dg 
PSUBC Sx, Sy, Dz 
PXOR Sx, Sy, Dz 


4.2.2 Data Move Instructions 
Mnemonics: 


Two types of data move instructions are available: dual memory move instructions and single 
memory move instructions. 


Dual memory move instructions specify data move, at the same time, between x memory and a 
DSP register, and between Y memory and a DSP register. 


Single memory move instructions specify data move between arbitrary memory and a DSP 
register. Table 4-6 lists data move instructions in mnemonic. 


Table 4-6 Data Move Instructions in Mnemonic 


Classification Mnemonic 
Dual memory move X memory move NOPX 
MOVX 
Y memory move NOPY 
MOVY 
Single memory move MOVS 


Operation Size: 
NOPX and NOPY instructions: Operation size cannot be specified. 


MOVX and MOVY instructions: Only word size (.W) can be specified. If omitted, word size is 
specified. 


MOVS instruction: Word size (.W) or longword size (.L) can be specified. If 
omitted, longword size is specified. 
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Addressing Mode: 
Table 4-7 lists addressing modes that can be specified for the data move instructions. 


Table 4-7 Addressing Modes of Data Move Instructions 


Addressing mode Description 

DSP register direct Dz 

Register indirect @Az 

Register indirect with post-increment @Az+ 

Register indirect with index/post-incremen @Az+lz 

Register indirect with pre-decrement — @Az — 7 


Register indirect with index/post-increment is a special addressing mode for the DSP data move 
instructions. In this mode, after referring to the contents indicated by register Az, register Az 
contents are incremented by the value of the Iz register. 


Registers that Can Be Specified in Addressing Modes: 


Table 4-8 lists registers that can be specified in the DSP register direct, register indirect, register 
indirect with post-increment, register indirect with index/post-increment, and register indirect 
with pre-decrement addressing modes. For Dx, Dy, Ds, Da, Ax, Ay, As, Ix, ly, and Is, refer to 
table 4-9, Data Move Instructions. 
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Table 4-8 Registers that Can Be Specified in Addressing Modes for Data Move 


Instructions 
General Register DSP Register 
R2 R3 R4 R5 R6 R7 R& RO AO A1 MO M1 XO X1 YO Y1 ADGA1G 
Dz Dx Yes Yes 
Dy Yes Yes 
Ds Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes 
Da Yes Yes 
Az Ax Yes Yes 
Ay Yes Yes 
As Yes Yes Yes Yes 
Iz Ix Yes 
ly Yes 
Is Yes 


Note: Warning 703 is displayed if the destination register for the DSP instruction and the 
destination register for the data move instruction are the same register, and if the 
instructions are in the same statement. 


Example: 


PADD AO,MO,YO NOPK MOVY.W @R6+,¥Y0 — Warning 703 


Data Move Instruction List: 
Table 4-9 lists data move instructions. For registers that can be specified for Dx, Dy, Ds, Da, Ax, 


Ay, As, Ix, ly, and Is, refer to table 4-8, Registers that Can Be Specified in Addressing Modes for 
Data Move Instructions. 
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Table 4-9 Data Move Instructions 


Classification Mnemonic Addressing Mode 

X data move instructions NOPX 
MOVX.W @Ax, Dx 
MOVX.W @Ax+, Dx 
MOVX.W @Axt+lx, Dx 
MOVX.W Da,@Ax _ 
MOVX.W Da, @Ax+ 
MOVX.W Da, @Ax+lx 

Y data move instructions NOPY 
MOVY.W @Ay, Dy 
MOVY.W @Ay+,Dy 
MOVY.W @Ay+ly, Dy 
MOVY.W Da, @Ay 
MOVY.W Da, @Ay+ 
MOVY.W Da, @Aytly 

Single data move instructions | MOVS.W @-As, Ds 
MOVS.W @As, Ds 
MOVS.W @As+, Ds 
MOVS.W @Ast+ls, Ds 
MOVS.W Ds, @-As 
MOVS.W Ds, @As 
MOVS.W ~ Ds, @As+ : 
MOVS.W Ds, @As+ls 
MOVS.L @-As, Ds 
MOVS.L @As, Ds 
MOVS.L @As+, Ds 
MOVS.L @As+ls, Ds 
MOVS.L Ds, @-As 
MOVS.L Ds, @As 
MOVS.L Ds, @As+ 
MOVS.L Ds, @As+ls 
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Section 5 Assembler Directives 


5.1 Overview of the Assembler Directives 


The assembler directives are instructions that the assembler interprets and executes. Table 5-1 
lists the assembler directives provided by this assembler. 


Table 5-1 Assembler Directives 


Type Mnemonic Function 

Target CPU .CPU Specifies the target CPU. 

Section and the location -SECTION Declares a section. 

counter ORG Sets the value of the location counter. 
-ALIGN Corrects the value of the location counter. 

Symbols -EQU Sets a symbol value (reset not allowed). 
-ASSIGN Sets a symbol value (reset allowed). 
-REG Defines the alias of a register name. 
.FREG Defines a floating-point register name. 

Data and data area -DATA Reserves integer data. 

reservation -DATAB Reserves integer data blocks. 
-SDATA Reserves character string data. 
-SDATAB Reserves character string data blocks. 
-SDATAC Reserves character string data (with length). 
-SDATAZ Reserves character string data (with zero 

terminator). 

-FDATA Reserves floating-point data. 
-FDATAB Reserves floating-point data blocks. 
-XDATA Reserves fixed-point data. 
-RES Reserves data area. 
-SRES Reserves character string data area. 
-SRESC Reserves character string data area (with length). 
-SRESZ Reserves character string data area (with zero 


terminator). 


.FRES Reserves floating-point data area. 
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Table 5-1 Assembler Directives (cont) 


Type Mnemonic Function 
Export and import symbol .EXPORT Declares export symbols. 
.IMPORT Declares import symbols. 
-GLOBAL Declares export and import symbols. 
Object modules -OUTPUT Controls object module output. 
.DEBUG Controls the output of symbolic debug information. 
-ENDIAN Selects big endian or little endian. 
-LINE Changes line number. 
Assemble listing -PRINT Controls assemble listing output. 
-LIST Controls the output of the source program listing. 
.-FORM Sets the number of lines and columns in the 
assemble listing. 
-HEADING Sets the header for the source program listing. 
.PAGE Inserts a new page in the source program listing. 
-SPACE Outputs blank lines to the source program listing. 
Other directives .PROGRAM Sets the name of the object module. 
-RADIX Sets the radix in which integer constants with no 
radix specifier are interpreted. 
-END Declares the end of the source program. 


104 HITACHI 


5.2 Assembler Directive Reference 


5.2.1 Target CPU Assembler Directive 


This assemble provides the following assembler directive concerned with the target CPU. 


- CPU 


Specifies the target CPU. 
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.CPU | 


Target CPU Specification 


Syntax 


~CPU <target CPU> 


Statement Elements 


L. 


Label 


The label field is not used. 


Operation 


Enter the .CPU mnemonic. 


Operands 
Enter the target CPU. 


Specification 


Target CPU 


SH1 Assembles program for SH-1 

SH2 Assembles program for SH-2 

SH2E Assembles program for SH-2E 

SH3 7 Assembles program for SH-3 a 
SH3E Assembles program for SH-3E 

SH4 Assembles program for SH-4 

SHDSP Assembles program for SH-DSP 

SH3DSP Assembles program for SH3-DSP 


This directive determines the target CPU. If it is omitted, the CPU specified by the SHCPU 
environment variable becomes valid. 


Reference: SHCPU environment variable 
— User's Guide, 1.3, "SHCPU Environment Variable" 
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- CPU 


Description 


1. .CPU is the assembler directive that specifies the target CPU for which the source program is 
assembled. 


N 


The following CPUs can be selected: 


* SHI (for SH-1) 

* SH2 (for SH-2) 

* SH2E (for SH-2E) 

* SH3 (for SH-3) 

* SH3E (for SH-3E) 

* SH4 (for SH-4) 

* SHDSP (for SH-DSP) 
* SH3DSP (for SH3-DSP) 


3. Specify this directive at the beginning of the source program. If it is not specified at the 
beginning, an error will occur. However, directives related to assembly listing can be written 
before this directive. 


4. When several .CPU directives are specified, only the first specification becomes valid. 


5. The assembler gives priority to target CPU specification in the order of -CPU, .CPU, and the 
SHCPU environment variable. 


Coding Example 


-CPU SH2 
-SECTION A, CODE, ALIGN=4 
MOV.L RO,R1 


MOV.L RO,R2 


Assembles program for SH-2. 


Reference: —CPU 
— User's Guide, 2.2.1, "CPU Command Line Option" -CPU 
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5252 Section and Location Counter Assembler Directives 


This assembler provides the following assembler directives concerned with sections and the 
location counter. 


- SECTION 


Declares a section. 


- ORG 


Sets the value of the location counter. 


- ALIGN 


Adjusts the value of the location counter to a multiple of the boundary alignment value. 
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- SECTION 


Section Declaration 


| .SECTION <section name> [,<section attribute> 
| [, {LOCATE= <start address>|ALIGN=<boundary alignment value>}]] 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the SECTION mnemonic. 
3. Operands 


— First operand: the section name 


The rules for section names are the same as the rules for symbols. 


References: Naming sections 
— Programmer's Guide, 1.3.2, "Coding of Symbols" 


— Second operand: the section attribute 


Attribute Section Type 

CODE Code section 

DATA Data section - 
STACK Stack section 

COMMON Common section 

DUMMY > Dummy section - 


The shaded section indicates the default value when the specifier is omitted. 


When the specification is omitted, the section will be a code section. 
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- SECTION 


— Third operand: start address or boundary alignment value 


Specification Section Type 

LOCATE = <start address> Absolute address section 

ALIGN = <boundary alignment value> Relative address section 

No specification Relative address section (boundary 


alignment value = 4) 


The specification determines whether the section type will be an absolute address section 
or a relative address section. 


Description 
1. .SECTION is the section declaration assembler directive. 


A section is a part of a program, and the linkage editor regards it as a unit of processing. The 
following describes section declaration using the simple examples shown below. 


This statement declares the start of 
section OD. 


This part of the source program 
belongs to section OD. 


This statement declares the start 
of section DT. 


This part of the source program 
belongs 10 section DT. 


This statement declares the start of 
section DM. 


This part of the source program 
belongs 10 section DM. 


This statement declares the end of the 
Source program. 


Note: This exampleassumes thatthe SECTION 
drecive does not appear inary of the source 
Statement set 1 OS. 
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- SECTION 


2. It is possible to redeclare (and thus restart, i.e., re-enter) a section that was previously 
declared in the same file. The following is a simple example of section restart. 


Source program 


SECTION GD ,GODE , ALIGN =4 This statement declares the start of 
SRE SERRE SrnaeS sae rasan slenssHnesntS section CD. 


This part of the source program 
belongs to section oD. 


This statement declares the restart 
of section GD. 


This part of the source program 

also belongs section CD. 

(This part of the program is 

i aie aca ees COntNLaton of source statement set 1} 


Note: This example assumes thatthe SECTION 
directive does notappearin any of the source 
Statement sets 1 tos. 


CAUTION! 


When using the SECTION directive to restart a section, the second and third operands must be 
omitted. (The original specifications when first declaring the section remain valid.) 


3. Use LOCATE = <start address> as the third operand when starting an absolute address 
section. The start address is the absolute address of the start of that section. 


The start address must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


The values allowed for the start address are from H'00000000 to H'FFFFFFFF. (From 0 to 
4,294,967,295 in decimal.) 
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- SECTION 


4. Use ALIGN = <boundary alignment value> to start a relative address section. The linkage 
editor will adjust the start address of the section to be a multiple of the boundary alignment 
value. 


The boundary alignment value must be specified as follows: 


— The specification must be an absolute value, 
and, 
— Forward reference symbols must not appear in the specification. 


The values allowed for the boundary alignment value are powers of 2, e.g. 29, 21, 22, ..., 231. 
For code sections, the values must be 4 or larger powers of 2, e.g. 22, 23, 24, ..., 231. 


5. The assembler provides a default section for the following cases: 


— The use of executable or extended instructions when no section has been declared. 
— The use of data reservation assembler directives when no section has been declared. 
— The use of the .ALIGN directive when no section has been declared. 

— The use of the .ORG directive when no section has been declared. 

— Reference to the location counter when no section has been declared. 


— The use of statements consisting of only the label field when no section has been 
declared. 


The default section is the following section: 


— Section name: P 


— Section type: Code section 
Relative address section (with a boundary alignment value of 4) 
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- SECTION 


Coding Example 


PRSESS SS Sas Seen Re eae cara se esos sS SSS 

1 1 

.ALIGH 4 > Thh +e fonoi te proqrmbebng b te detutdectn PB 
1 1 

H DATA. L H'11111111 1) Thedetunsecdon Pleacode decton, andi+ardaie 

' ' 

— > addred4 tec fon it 4 boundaryalgiment we 014. 

! ' 

Fs ft ag i ke a pn Sc isos pe 4 


! 1 

! ' 

Moy? ho, Rl > Thh+e toned he progrmbebng © te sect CD 

' rt 3 ! 

! Mov BO, Re 1; The tecfon CD ha code tecton, and ha eldue addres 
1! ! 

— 1 secon ath a boundary alignment uaue od. 

1 ! 

Lama a maa eee aaa eee ema sea eesaee 4 


PRR SSSSE SSeS Rasa Rese aces eee SaSSeeRSSSSSesars 
xl: .DATA.L H' 22222222 > Thh +e ionod he program bebo © te ecto DT. 
-DATA.L A’ 33333333 ; The ecfonDTh 4 dats secton, andl+ anabsout address 
——— > ton wth tor addres oT HOOT O00, 
ieeeebess aces bee tee nen nsatin pated) H 

. EHD 


Note: This example assumes the .SECTION directive does not appear in the parts indicated by 


Nell 
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-ORG 


Location-Counter-Value Setting 


Syntax 


-ORG <location-counter-value> 


Statement Elements 


1. 


Label 


The label field is not used. 


2. Operation 
Enter the .ORG mnemonic. 

3. Operands 
Enter the new value for the location counter. 

Description 

1. .ORG is the assembler directive that sets the value of the location counter. The .ORG 
directive is used to place executable instructions or data at a specific address. 

2. The location-counter-value must be specified as follows: 


— The specification must be an absolute value or an address within the section, 
and, 


— Forward reference symbols must not appear in the specification. 


The values allowed for the location-counter-value are from H'00000000 to H'FFFFFFFF. 
(From 0 to 4,294,967,295 in decimal.) 


When the location-counter-value is specified with an absolute value, the following condition 
must be satisfied: 


<location-counter-value>__<section start address>_ (when compared as unsigned values) 
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-ORG 


3. The assembler handles the value of the location counter as follows: 
— The value is regarded as an absolute address value within an absolute address section. 
— The value is regarded as a relative address value (relative distance from the section head) 
within a relative address section. 
Coding Example 


- SECTION DT, DATA, LOCATE=H'FFFF0000 


-DATA.L HB LiLiiii1 

-ORG H'FFFFO010 F 

.-DATA.L H'22222222 ; 
~~ 


Abed ute address 
HFFFFoooo 


Absolute address 
HFFFFooio 


This statement sets the value of the location 


; counter. 


The integer data H'22222222 is stored at 
absolute address H'FFFF0010. 


Locations from H FFF Fooo4 
tO H'FFFFOOOF are not 
changed due to the use of 
the .ORG assembler directive. 
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- ALIGN 


Location-Counter-Value Correction 


Syntax 


.ALIGN <boundary alignment value> 


Statement Elements 


1. 


Label 


The label field is not used. 


2. Operation 
Enter the ALIGN mnemonic. 
3. Operands 
Enter the boundary alignment value. 
Description 
1. .ALIGN is the assembler directive that corrects the location-counter-value to be a multiple of 
the boundary alignment value. Executable instructions and data can be allocated on specific 
boundary values (address multiples) by using the .ALIGN directive. 
2. The boundary alignment value must be specified as follows: 
— The specification must be an absolute value, 
and, 
— Forward reference symbols must not appear in the specification. 
The values allowed for the boundary alignment value are powers of 2, e.g. 29, 21, 22, ..., 231. 
3. When .ALIGN is used in a relative section the following must be satisfied: 


Boundary alignment value specified by SECTION > Boundary alignment value specified 
by .ALIGN 
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- ALIGN 


4. When .ALIGN is used in a code section, the assembler inserts NOP instructions in the object 
code* to adjust the value of the location counter. Odd byte size areas are filled with H'09. 


Note: This object code is not displayed in the assemble listing. 


When .ALIGN is used in a data, dummy, or stack section, the assembler only adjusts the 
value of the location counter, and does not fill in any object code in memory. 


Coding Example 


- SECTION P,code 


DATA.B HP 11 

DATA.B H'22 

DATA.B H'33 

ALIGN 2 ; This statement adjusts the value of the location 
-DATA.W H'4444 ; counter to be a multiple of 2. 
. ALIGN 4 ; This statement adjusts the value of the location 
.DATA.L H'55555555 ; counter to be a multiple of 4. 


Explanatory Figure for the Coding Example 


This example assumes that the byte-sized integer data H11 is originally located at the 
4-byte boundary address. The assembler will insert the Filler data as shown inthe figure 
below. 


4byte — a 
boundary 


eee 
Hit | H22 TH33 [HOo- 


Memory 


H S399 IIo 


PEE : Codes filled in by 


the assembler. 
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5.2.3 Symbol Handling Assembler Directives 


This assembler provides the following assembler directives concerned with symbols. 


| .EQU 


Sets a symbol value. 


| - ASSIGN 


Sets and resets a symbol value. 


-REG 


Defines the alias of a register name. 


. FREG 


Defines a floating-point register name. 
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-EQU 


Symbol Value Setting (Resetting Not Allowed) 


Syntax 


| <symbol>[:] .EQU <symbol value> 


Statement Elements 
1. Label 
Enter the symbol to which a value is to be set. 
2. Operation 
Enter the .EQU mnemonic. 
3. Operands 
Enter the value to be set to the symbol. 
Description 
1. .EQU is the assembler directive that sets a value to a symbol. 


Symbols defined with the .EQU directive cannot be redefined. 


N 


The symbol value must be specified as follows: 


— The specification must be an absolute value, an address value, or an import symbol value* 
and, 


— Forward reference symbols must not appear in the specification. 


The values allowed for the symbol value are from H'00000000 to H'FFFFFFFF. 
(From -2,147,483,648 to 4,294,967,295 in decimal.) 


Note: An import value, import value + constant, or import value — constant can be 
specified. 
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-EQU 


Coding Example 
X1: EQU 10 ; The value 10 is set to X1. 
X2: EQU 20 ; The value 20 is set to X2. 
CMP/EQ #X1,R0 ; This is the same as CMP/EQ #10,RO. 
BT LABEL1 
CMP/EQ #X2,RO ; This is the same as CMP/EQ #20,RO. 
BT LABEL2 
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- ASSIGN 


Symbol Value Setting (Resetting Allowed) 


Syntax 


<symbol>[:] .ASSIGN <symbol value> 


Statement Elements 
1. Label 
Enter the symbol to which a value is to be set. 
2. Operation 
Enter the ASSIGN mnemonic. 
3. Operands 
Enter the value to be set to the symbol. 
Description 
1. .ASSIGN is the assembler directive that sets a value to a symbol. 


Symbols defined with the ASSIGN directive can be redefined with the .ASSIGN directive. 


nN 


The symbol value must be specified as follows: 


— The specification must be an absolute value or an address value, 
and, 


— Forward reference symbols must not appear in the specification. 


The values allowed for the symbol value are from H'00000000 to H'FFFFFFFF. (From 0 to 
4,294,967,295 in decimal.) 


3. Definitions with the .ASSIGN directive are valid from the point of the definition forward in 
the program. 
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- ASSIGN 


4. Symbols defined with .ASSIGN have the following limitations: 


— They cannot be used as export or import symbols. 


— They cannot be referenced from the debugger. 


Coding Example 


X1: . ASSIGN 
| X2: . ASSIGN 
CMP/EQ 
BT 

CMP/EQ 


BT 


XL: . ASSIGN 

X2: . ASSIGN 
CMP/EQ 
BT 
CMP/EQ 
BF 


4 

#X1,RO0 
LABEL3 
#X2,RO 
LABEL4 


i 


i 


7 


7 


; This is the same as CMP/EQ #1,RO. 


This is the same as CMP/EQ #2,R0. 


; This is the same as CMP/EQ #3,R0. 


This is the same as CMP/EQ #4,RO0. 
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- REG 


Register Name Alias Definition 


<symbol>[:] .REG <register name> 


<symbol>[:] .REG (<register name>) 


or 


Statement Elements 


1. Label 
Enter the symbol to be defined as the alias of a register name. 
2. Operation 
Enter the .REG mnemonic. 
3. Operands 
Enter the register name for which the alias of a register name is being defined. 
Description 
1. .REG is the assembler directive that defines the alias of a register name. 
The alias of a register name defined with .REG can be used in exactly the same manner as 
the original register name. 
The alias of a register name defined with .REG cannot be redefined. 
2. The alias of a register name can only be defined for the general registers (RO to R15, and SP). 
3. Definitions with the .REG directive are valid from the point of the definition forward in the 
program. 
4. Symbols defined with .REG have the following limitations: 


— They cannot be used as import or export symbols. 


— They cannot be referenced from the simulator/debugger. 
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. REG 


nn SEE EEE 


Coding Example 
MIN: .REG R10 | 
MAX REG R11 | 
MOV #0,MIN ; This is the same as MOV #0,R10. 
MOV #99,MAX ; This is the same as MOV #99,R11. 


CMP/HS MIN,R1 
BF LABEL 
CMP/HS R1,MAX 
BF LABEL 


i 
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. FREG 


Floating-Point Register Name Alias Definition 


Syntax 


| 
<symbol>[:] .FREG <floating-point register name> 


or 
<symbol>[:] .FREG (<floating-point register name>) 


Statement Elements 
1. Label 
Enter the symbol to be defined as a floating-point register name. 
2. Operation 
Enter the FREG mnemonic. 
3. Operands 
Enter the floating-point register name for which the alias is to be defined. 
Description 
1. .FREG is the assembler directive that defines the alias of a floating-point register name. 


The alias of a floating-point register name defined with .FREG can be used in exactly the 
same manner as the original register name. 


The alias of a floating-point register name defined with .FREG cannot be redefined. 


2. The alias can only be defined for the floating-point registers FRm (m = 0 to 15), DRn (n= 0, 
2, 4, 6, 8, 10, 12, 14), XDn (n = 0, 2, 4, 6, 8, 10, 12, 14), and FVi (i = 0, 4, 8, 12). 


3. Definitions with the .FREG are valid from the point of the definition forward in the program. 
4. Symbols defined with .FREG have the following limitations: 


— They cannot be used as import or export symbols. 
— They cannot be referenced from the simulator/debugger. 
5. .FREG is valid only when SH-2E, SH-3E, or SH-4 is selected as the CPU type. 
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. FREG | 


Coding Example 
| 
MAX: . FREG FR11 
FMOV @FR1,MAX ; This is the same as FMOV @FR1,FR11. 
| 
FCMP/EQ MAX, FR2 ; This is the same as FCMP/EQ FR11,FR2. 
BF LABEL 


—————————————————— 
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5.2.4 Data and Data Area Reservation Assembler Directives 


This assembler provides the following assembler directives that are concerned with data and data 


area reservation. 


- DATA 


-DATAB 


-SDATA 


- SDATAB 


- SDATAC 


- SDATAZ 


- FDATA 


. FDATAB 


-XDATA 


-RES 


Reserves integer data. 


Reserves integer data blocks. 


Reserves character string data. 


Reserves character string data blocks. 


Reserves character string data (with length). 


Reserves character string data (with zero terminator). 


Reserves floating-point data. 


Reserves floating-point data block. 


Reserves fixed-point data. 


Reserves data area. 


Reserves character string data area. 


Reserves character string data area (with length). 


Reserves character string data area (with zero terminator). 


Reserves floating-point data area. 
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-DATA 


Integer Data Reservation 


Syntax 


[<symbol>[:]] .DATA[.<operation size>] <integer data> 


[,<integer data>.. 


J 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 


Enter .DATA mnemonic. 


— Operation size 


Specifier Data Size 

B Byte 

w 7 Word (2 bytes) 
L Longword (4 bytes) 


Ee i 
The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of the reserved data. 
The longword size is used when the specifier is omitted. 


3. Operands 
Enter the values to be reserved as data in the operand field. 
Description 


1. .DATA is the assembler directive that reserves integer data in memory. 


2. Arbitrary values, including relative values and forward reference symbols, can be used to 


specify the integer data. 


a 
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- DATA 


3. The range of values that can be specified as integer data varies with the operation size. 


Operation Size Integer Data Range* 

B H'00000000 to H'OO00000FF = (0 to 255) 
H'FFFFFF80 to H'FFFFFFFF (—128 to —1) 

WwW H'00000000 to H'OOOOFFFF = (0 to 65,535) 
H'FFFF8000 to H'FFFFFFFF (—32,768 to —1) 

L. H'00000000 to H'7FFFFFFF (0 to 4,294,967,295) 
H'80000000 to H'FFFFFFFF (-—2,147,483,648 to —1) 


Note: Numbers in parentheses are decimal. 


Coding Example 


~ 
. ALIGN 4 ; (This statement adjusts the value of the 
location counter.) 
X: -DATA.L H'11111111 ; 
-DATA.W H'2222,H°3333 ; These statements reserve integer data. 
-DATA.B H'44,H'55 ; 


_ Note: The data inthis igure 


is hesadeciral. 
4 Bytes 
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. DATAB 


Integer Data Block Reservation 


Syntax 


[<symbol>[:]] .DATAB[.<operation size>] <block count>,<integer data> 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 
Enter .DATAB mnemonic. 


— Operation size 


Specifier Data Size 

B Byte 

Ww ~ Word (2 bytes) 

L Longword (4 bytes) 


i a ear eno 
The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of the reserved data. 
The longword size is used when the specifier is omitted. 


3. Operands 


— First operand: block count 
Enter the number of times the data value is repeated as the first operand. 


— Second operand: integer data 
Enter the value to be reserved as the second operand. 


a 


130 HITACHI 


- DATAB 


Description 


1. .DATAB is the assembler directive that reserves the specified number of integer data items 
consecutively in memory. 


N 


The block count must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


Arbitrary values, including relative values and forward reference symbols, can be used to 
specify the integer data. 


3. The range of values that can be specified as the block size and as the integer data varies with 
the operation size. 


Operation Size Block Size Range* 

B H'00000001 to H'FFFFFFFF (1 to 4,294,967,295) 

W H'00000001 to H'7FFFFFFF (1 to 2,147,483,647) 

L H'00000001 to H'3FFFFFFF (1 to 1,073,741,823) 

Operation Size Integer Data Range* 

B H'00000000 to H'‘OOO000FF (0 to 255) 
H'FFFFFF80 to H'FFFFFFFF (-—128 to —1) 

WwW H'00000000 to H'OOOOFFFF (0 to 65,535) 
H'FFFF8000 to H'FFFFFFFF (—32,768 to —1) 

L H'00000000 to H'7FFFFFFF (0 to 4,294,967,295) 
H'80000000 to H'FFFFFFFF (—2,147,483,648 to —1) 


Note: Numbers in parentheses are decimal. 
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- DATAB 


a 


Coding Example 


| ~ 
. ALIGN 4 ; (This statement adjusts the value of the 
; location counter.) 
X: .DATAB.L a © OA BB es ; 
. DATAB .W 2,H'2222 ; This statement reserves two blocks of integer 
.DATAB.B 3,H'33 ; data. 


Address symbol 
x 


Note: The data in this igure 


‘_____,_—___ is hexadecirral. 


i 
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-SDATA 


Character String Data Reservation 


Syntax 


[<symbol>[:]] .SDATA "<character string>"[,"<character string>"...] 


Statement Elements 
1. Label 


Enter a reference symbol if required. 


2. Operation 

Enter the SSDATA mnemonic. 
3. Operands 

Enter the character string(s) to be reserved. 
Description 


1. .SDATA is the assembler directive that reserves character string data in memory. 
Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 
2. Accontrol character can be appended to a character string. 


The syntax for this notation is as follows: 


"<character string>"<<ASCII code for a control character>> 


The ASCII code for a control character must be specified as follows: 


_—— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 
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| . SDATA | 


Coding Example 

. ALIGN 4 ; (This statement adjusts the value of 

; the location counter.) 
X: .SDATA "ARAAA" ; This statement reserves character string data. 

.SDATA nu BBB ; The character string in this example includes 
; double quotation marks. 

. SDATA "ABAB" <H'07> ; The character string in this example has 
; acontrol character appended. | 


Motes: 4. The data in this igure is 
hexadecirral. 


2. The ASC!) code for "A"is: H'41. 
The ASCII code for "B'is: H'42. 
The ASCII code for "is: H22. 


ae eee 
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- SDATAB 


Character String Data Blocks Reservation 


Syntax 


[<symbol>[:]] .SDATAB <block count>,"<character string>" 


Statement Elements 
1. Label 
Enter a reference symbol if required. 
2. Operation 
Enter the SDATAB mnemonic. 
3. Operands 


— First operand: <block count> 


Enter the number of character strings as the first operand. 


— Second operand: <character string> 


Enter the character string to be reserved as the second operand. 


Description 


1. .SDATAB is the assembler directive that reserves the specified number of character strings 


consecutively in memory. 


Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 


N 


The <block count> must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


A value of | or larger must be specified as the block count. 


The maximum value of the block count depends on the length of the character string data. 
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| . SDATAB | 


(The length of the character string data multiplied by the block count must be less than or 
equal to H'FFFFFFFF (4,294,967,295) bytes.) 


3. A control character can be appended to a character string. 


The syntax for this notation is as follows: 


| 


| "echaracter string>"<<ASCII code for a control character>> 


The ASCII code for a control character must be specified as follows: 


— The specification must be an absolute value, 
and, 
_— Forward reference symbols must not appear in the specification. 


ee ee a a 
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- SDATAB 


Coding Example 
| 
| . ALIGN 4 ; (This statement adjusts the value of the 
; location counter.) 
X: . SDATAB 2, "AAAAA" ; This statement reserves two character string 
; data blocks. 
. SDATAB 2, MUIBR BHM ; The character string in this example includes 
| ; double quotation marks. 
| . SDATAB 2,"ABAB"<H'07>  ; The character string in this example has 
; acontrol character appended. 


Notes: 1. The data in this figureis 
hexadecimal. 


2. The ASCII code for"A’ is: HH. 
The ASC! code for"B" is: H'42. 
The ASC! code for’ is: Hae. 
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- SDATAC 


Character String Data Reservation (With Length) 


Syntax 


[<symbol>[:]] .SDATAC "<character string>"[,"<character Strings" occ) 


Statement Elements 
1. Label 
Enter a reference symbol if required. 
2. Operation 
Enter the SDATAC mnemonic. 
3. Operands 
Enter the character string(s) to be reserved. 
Description 


1. .SDATAC is the assembler directive that reserves character string data (with length) in 
memory. 


A character string with length is a character string with an inserted leading byte that 
indicates the length of the string. 


The length indicates the size of the character string (not including the length) in bytes. 
Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 
2. Acontrol character can be appended to a character string. 


The syntax for this notation is as follows: 


"echaracter string>"<<ASCII code for a control character>> 


The ASCII code for a control character must be specified as follows: 


i ED 


138 HITACHI 


- SDATAC 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


Coding Example 


. ALIGN 4 ; (This statement adjusts the value of the 

; location counter.) 
X: . SDATAC "AAAAA" ; This statement reserves character string 

; data (with length). 

. SDATAC 1 BBB Mien ; The character string in this example includes 
; double quotation marks. 

. SDATAC "ABAB" <H'07> ; The character string in this example has 
; acontrol character appended. 


Memory 


P42 07 || Notes: 4. The data inthis igure is 
hesadecinnal. 


2. The ASCH) code tor "A" is: Hd. 


—_.,._! The ASCH code for "B"is: H42. 


The ASCH cade for "is: Hae. 
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- SDATAZ 


Character String Data Reservation (With Zero Terminator) 


Syntax 


[<symbol>[:]] .SDATAZ "<character string>"[,"<character string>"...] 


Statement Elements 
1. Label 
Enter a reference symbol if required. 
2. Operation 
Enter the SDATAZ mnemonic. 
3. Operands 
Enter the character string(s) to be reserved. 
Description 


1. .SDATAZ is the assembler directive that reserves character string data (with zero terminator) 
in memory. 


A character string with zero terminator is a character string with an appended trailing byte 
(with the value H'00) that indicates the end of the string. 


Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 
2. Acontrol character can be appended to a character string. 


The syntax for this notation is as follows: 


"echaracter string>"<<ASCII code for a control character>> 


The ASCII code for a control character must be specified as follows: 
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- SDATAZ 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


Coding Example 


. ALIGN 4 ; (This statement adjusts the value of the 

; location counter.) 
Xx: . SDATAZ "DAAAA" ; This statement reserves character string 

; data (with zero terminator). 

. SDATAZ ow BBB ; The character string in this example 
; includes double quotation marks. 

. SDATAZ "ABAB" <H'07> ; The character string in this example has 
; acontrol character appended. 


Address 
symbol 


hexadecimal. 


2. The ASO ll code for"A" is: H'44. 
‘'___, —__! The ASC Il code for"B" is: H'42. 


The ASC ll code for’ is: Hae. 
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.FDATA 


Floating-Point Data Reservation 


ae 


Syntax 


[<symbol>[:]] .FDATA[.operation size] <floating-point data> | 
[,<floating-point data>...] | 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 
Enter .FDATA mnemonic. 


— Operation size 


Specifier Data Size 
iS) Single precision (4 bytes) 
D Double precision (8 bytes) 


eee 
The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of the reserved data. 
Single precision is used when the specifier is omitted. 


3. Operands 
Enter the values to be reserved as data. 
Description 
1. .FDATA is the assembler directive that reserves floating-point data in memory. 


Reference: Floating-point data 
— Programmer's Guide, 1.4.3, "Floating-Point Constants" 


a nl 
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. FDATA 


Coding Example 

. ALIGN 4 ; (This statement adjusts the value of the 

; location counter.) 
X: .FDATA.S F'1.234S ; This statement reserves a 4-byte area 

; 3F9ODF3B6 (F'1.234S). 

. FDATA.S H'7F800000.S ; This statement reserves a 4-byte area 
; 7F800000 (H'F800000.S). 

. FDATA.D F'4.32D-1 ; This statement reserves an 8-byte area 
; 3FDBA5E353F7CED9 (F'4.32D-1). 
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.- FDATAB 


Floating-Point Data Block Reservation 


Syntax 


[<symbol>[:]] .FDATAB[.operation size] <block count>, 
<floating-point data> 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 
Enter .FDATAB mnemonic. 


— Operation size 


Specifier Data Size 
Ss Single precision (4 bytes) 
D Double precision (8 bytes) 


is ee 
The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of the reserved data. 
Single precision is used when the specifier is omitted. 


3. Operands 


— First operand: block count 
Enter the number of times the data value is repeated as the first operand. 


— Second operand: floating-point data 
Enter the floating-point data to be reserved as the second operand. 


Description 


1. .FDATAB is the assembler directive that reserves the specified number of floating-point data 
items consecutively in memory. 


i nea, ee EEE yaad 
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- FDATAB 


The block count must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols, export symbols, and relative symbols must not appear in 
specification. 


The range of values that can be specified as the block size varies with the operation size. 


Operation Size Block Size Range* 
S) H'00000001 to H'3FFFFFFF (1 to 1,073,741,823) 
D H'00000001 to H'1FFFFFFF (1 to 536,870,911) 


Note: Numbers in parentheses are decimal. 


Reference: Floating-point data 
— Programmer's Guide, 1.4.3, "Floating-Point Constants" 
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- FDATAB 


Coding Example 


— ] 


. ALIGN 4 ; (This statement adjusts the value of the 
; location counter.) | 
X: . FDATAB.S 2,H'7F800000.S ; This statement reserves two blocks of 4-byte | 
; areas 7F800000 (H'7F800000.S). | 
-FDATAB.D 3,F'4.32D-1 ; This statement reserves three blocks of 8-byte | 
| ; areas 3FDBA5E353F7CED9 (F'4.32D-1). 


Address syrbol 
x 


i 
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-XDATA 


Fixed-Point Data Reservation 


Syntax 


[<symbol>[:]] .XDATA[.<operation size>] <fixed-point data> 
[,<fixed-point data>...] 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 
Enter .XDATA mnemonic. 


— Operation size 


Specifier Data Size 
WwW Word (2 bytes) 
L Longword (4 bytes) 


The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of the reserved data. 


The longword size is used when the specifier is omitted. 
3. Operands 
Enter the fixed-point data to be reserved as data in the operand field. 
Description 
1. .XDATA is the assembler directive that reserves fixed-point data in memory. 


Reference: Fixed-point data 
— Programmer's Guide, 1.4.4, "Fixed-Point Constants" 
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.XDATA 


SE 


Coding Example 
. ALIGN 4 ; (This statement adjusts the value of the 

; location counter.) 
X: .XDATA.L 0.5 ; This statement reserves 4-byte area 

; (H'40000000). 

.XDATA.W 0:.'75)0..25 ; This statement reserves 2-byte areas 

; (H'6000) and (H'2000). 
ee ee ee ee en eee pe ee ee oe 
| Explanatory Figure for the Coding Execple 1 | 
H ! | 
Memory 
H Address symbol 
H x ' 
1 H 
[60 00 | 2000 | 
! ! 
H i 
H I 
——— ! 
4 bytes 
Leite seaee wet S a ccicatteeicnincecuin beta aecenearaaneisie ones ee ee ee ccaicemesatoccmeneeeneas H 
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-RES 


Data Area Reservation 


Syntax 


([<symbol>[:]] .RES[.<operation size>] <area count> 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 


Enter .RES mnemonic. 


— Operation size 


Specifier Data Size 

B Byte 

Ww Word (2 bytes) _ 

L Longword (4 bytes) 


The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of one area. 


The longword size is used when the specifier is omitted. 
3. Operands 


Enter the number of areas to be reserved in the operand field. 
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. RES 


a 


Description 
1. .RES is the assembler directive that reserves data areas in memory. 
2. The area count must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


3. The range of values that can be specified as the area count varies with the operation size. 


Operation Size Area Count Range* 

B H'00000001 to H'FFFFFFFF (1 to 4,294,967,295) 
WwW ~_H'00000001 to H'7FFFFFFF (1 to 2,147,483,647) 
L H'00000001 to H'3FFFFFFF (1 to 1,073,741,823) 


Note: Numbers in parentheses are decimal. 


aE 
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Coding Example 
. ALIGN 4 ; (This statement adjusts the value of the location 
; Counter.) 

| X: -RES.L 2 ; This statement reserves two longword-size areas. 
| .RES.W 3 ; This statement reserves three-word-size areas. 
| 
| .RES.B 5 ; This statement reserves five-byte-size areas. 

pike ec ee ee eee ten cece ecenen eerie bee eawetoceieakaek res 


Expbnatony Figure for the Coding Exampk 


Memory 


Address synibal 
x 


# 


e 


“ 
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-SRES 


Character String Data Area Reservation 


Syntax 


[<symbol>[:]] .SRES <character string area size> 
| [,<character string area size>...] 


Statement Elements 
1. Label 
Enter a reference symbol if required. 
2. Operation 
Enter the .SRES mnemonic. 
3. Operands 
Enter the sizes of the areas to be reserved in byte units. 
Description 
1. .SRES is the assembler directive that reserves character string data areas. 
2. The character string area size must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 


The values that are allowed for the character string area size are from H'00000001 to 
H'FFFFFFFF (from 1 to 4,294,967,295 in decimal). 
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-SRES 


Coding Example 


. ALIGN 4 ; (This statement adjusts the value of the location 
; counter.) 
X: . SRES z ; This statement reserves a 7-byte area. 
. SRES 6 ; This statement reserves a 6-byte area. 


Exphnatony Figure for the Coding Exampk 
Memory 


Address symbol 


a 


{7 


BRROS S008 IN 777, 
| 
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-SRESC 


Character String Data Area Reservation (With Length) 


Syntax 


[<symbol>[:]] .SRESC <character string area size> 
{,<character string area size>...] 


Statement Elements 
1. Label 
Enter a reference symbol if required. 
2. Operation 
Enter the SRESC mnemonic. 
3. Operands 
Enter the sizes of the areas (not including the length) to be reserved in byte units. 
Description 


1. .SRESC is the assembler directive that reserves character string data areas (with length) in 
memory. 


A character string with length is a character string with an inserted leading byte that 
indicates the length of the string. 


The length indicates the size of the character string (not including the length) in bytes. 
Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 
2. The character string area size must be specified as follows: 


— The specification must be an absolute value, 
and, 
— Forward reference symbols must not appear in the specification. 


The values that are allowed for the character string area size are from H'00000000 to 
H'000000FF (from 0 to 255 in decimal). 


Neen ee eee eee ee ee ee LEE EEA 
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-SRESC 


3 


The size of the area reserved in memory is the size of the character string area itself plus 1 


byte for the count. 


Coding Example 


(pian 


. ALIGN 4 ; (This statement adjusts the value of the location 
; counter.) 
X: - SRESC 7 ; This statement reserves 7 bytes plus 1 byte for 
; the count. 
. SRESC 6 ; This statement reserves 6 bytes plus 1 byte for 
; the count. 


Memory 


UW 
en ec 
Pa 
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- SRESZ 


Character String Data Area Reservation (With Zero Terminator) 


Syntax 


[<symbol>[:]] .SRESZ <character string area size> 


{,<character string area size>...] 


Statement Elements 


i 


Label 

Enter a reference symbol if required. 
Operation 

Enter the .SRESZ mnemonic. 
Operands 


Enter the sizes of the areas (not including the terminating zero) to be reserved in byte units. 


Description 


1. 


.SRESZ is the assembler directive that allocates character string data areas (with zero 
termination). 


A character string with length is a character string with an appended trailing byte (with the 
value H'00) that indicates the end of the string. 


Reference: Character strings — Programmer's Guide, 1.7, "Character Strings" 
The character string area size must be specified as follows: 


— The specification must be an absolute value, 
and, 
— Forward reference symbols must not appear in the specification. 


The values that are allowed for the character string area size are from H'00000000 to 
H'000000FF (from 0 to 255 in decimal). 
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3. 
byte for the terminating zero. 


Coding Example 


- SRESZ 


The size of the area reserved in memory is the size of the character string area itself plus 1 


. ALIGN 4 
counter.) 
X: . SRESZ a 
. SRESZ 6 


i 


i 


Erie ies OE ee 
ETHEL CA 


N 
N 


(This statement adjusts the value of the location 


This statement reserves 7 bytes plus 1 byte for 


; the terminating byte. 


This statement reserves 6 bytes plus 1 byte for 
the terminating byte. 
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- FRES 


Floating-Point Data Area Reservation 


Syntax 


[<symbol>[:]] .FRES[S] <area count> 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


— Mnemonic 
Enter .FRES mnemonic. 


— Operation size 


Specifier Data Size 
S} Single precision (4 bytes) 
D Double precision (8 bytes) 


The shaded section indicates the default value when the specifier is omitted. 


The specifier determines the size of one area. 


Single precision is used when the specifier is omitted. 
3. Operands 
Enter the number of areas (the number of single-precision data items). 
Description 
1. .FRES is the assembler directive that reserves floating-point data areas in memory. 
2. The area count must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols, import symbols, and relative symbols must not appear in the 
specification. 
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-FRES 


Coding Example 


. ALIGN 4 ; (This statement adjusts the value of the location 
; counter.) 
X: .FRES.S 2 ; This statement reserves two areas. 
. FRES.D 3 ; This statement reserves three areas. 
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5.2.5 Export and Import Assembler Directives 


This assembler provides the following assembler directives concerned with export and import. 


| - EXPORT 


Declares export symbols. 


This declaration allows symbols defined in the current file to be referenced in other files. 


| . IMPORT 


Declares import symbols. 


This declaration allows symbols defined in other files to be referenced in the current file. 


- GLOBAL 


Declares export and import symbols. 


This declaration allows symbols defined in the current file to be referenced in other files, and 
allows symbols defined in other files to be referenced in the current file. 
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- EXPORT 


Export Symbols Declaration 


Syntax 


-EXPORT <symbol>[,<symbol>...] 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the EXPORT mnemonic. 
3. Operands 
Enter the symbols to be declared as export symbols. 
Description 
1. .EXPORT is the assembler directive that declares export symbols. 


An export symbol declaration is required to reference symbols defined in the current file from 
other files. 


2. The following can be declared to be export symbols. 


— Constant symbols (other than those defined with the .ASSIGN directive) 
— Absolute address symbols (other than address symbols in a dummy section) 
— Relative address symbols 


3. To reference a symbol as an import symbol, it is necessary to declare it to be an export 


symbol, and also to declare it to be an import symbol. 


Import symbols are declared in the file in which they are referenced using either the 
IMPORT or the .GLOBAL directive. 
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I - EXPORT 


Coding Example 


(In this example, a symbol defined in file A is referenced from file B.) 


File A: 
. EXPORT x ; This statement declares X to be an export 
; symbol. 
X: . EQU H'10000000 ; This statement defines X. 
| 
| File B: 
.IMPORT X ; This statement declares X to be an import 
; symbol. 
| 
. ALIGN 4 
.DATA.L x ; This statement references X. 
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- IMPORT 


Import Symbols Declaration 


Syntax 


. IMPORT <symbol>[,<symbol>...] 


Statement Elements 


i 


Label 


The label field is not used. 


2. Operation 
Enter the IMPORT mnemonic. 
3. Operands 
Enter the symbols to be declared as import symbols. 
Description 
1. .IMPORT is the assembler directive that declares import symbols. 
An import symbol declaration is required to reference symbols defined in another file. 
2. Symbols defined in the current file cannot be declared to be import symbols. 
3. To reference a symbol as an import symbol, it is necessary to declare it to be an export 


symbol, and also to declare it to be an import symbol. 


Export symbols are declared in the file in which they are defined using either the EXPORT 
or the .GLOBAL directive. 
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- IMPORT 


Coding Example 


(In this example, a symbol defined in file A is referenced from file B.) 


File A: 
-EXPORT X ; This statement declares X to be an export 
; symbol. 
X: . EQU H'10000000 ; This statement defines X. 
File B: 
-IMPORT X ; This statement declares X to be an import 
; symbol. 
ALIGN 4 


; This statement references X. 


164 HITACHI 


- GLOBAL 


Export and Import Symbols Declaration 


Syntax 


.GLOBAL <symbol>[,<symbol>...] 


Statement Elements 


lL. 


Label 


The label field is not used. 


2. Operation 
Enter the .GLOBAL mnemonic. 

3. Operands 
Enter the symbols to be declared as export symbols or as import symbols. 

Description 

1. .GLOBAL is the assembler directive that declares symbols to be either export symbols or 
import symbols. 
An export symbol declaration is required to reference symbols defined in the current file from 
other files. An import symbol declaration is required to reference symbols defined in another 
file. 

2. A symbol defined within the current file is declared to be an export symbol by a .GLOBAL 
declaration. 
A symbol that is not defined within the current file is declared to be an import symbol by a 
-GLOBAL declaration. 

3. The following can be declared to be export symbols. 


— Constant symbols (other than those defined with the .ASSIGN assembler directive) 
— Absolute address symbols (other than address symbols in a dummy section) 
— Relative address symbols 
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- GLOBAL 


4. Toreference a symbol as an import symbol, it is necessary to declare it to be an export 


symbol, and also to declare it to be an import symbol. 


Export symbols are declared in the file in which they are defined using either the EXPORT 
or the .GLOBAL directive. 


Import symbols are declared in the file in which they are referenced using either the 


IMPORT or the .GLOBAL directive. 


Coding Example 


(In this example, a symbol defined in file A is referenced from file B.) 


File A: 
[ 
-GLOBAL xX ; This statement declares X to be an export 
; symbol. | 
X: .EQU H'10000000 __ ; This statement defines X. | 
File B: 
- GLOBAL x ; This statement declares X to be an import 
; symbol. 
ALIGN 
DATA.L xX ; This statement references X. 
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5.2.6 | Object Module Assembler Directives 


This assembler provides the following assembler directives concerned with object modules. 


- OUTPUT 


Controls object module and debug information output. 


- DEBUG 


J 


Controls the output of symbolic debug information. 


.ENDIAN | 


Selects big endian or little endian. 


- LINE 


Changes line number. 
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-OUTPUT 


Object Module Output Control 


Syntax 


.OUTPUT <output specifier>[,<output specifier>] 


Statement Elements 


1. Label 


The label field is not used. 


2. Operation 


Enter the .OUTPUT mnemonic. 


3. Operands: <output specifier> 


Output Specifier 


Output Control 


OBJ An object module is output. 

NOOBJ No object module is output. i 
DBG a Debug information is output in the object module. 

NODBG No debug information is output in the object module. 


The shaded section indicates the default value when the specifier is omitted. 


The output specifiers control object module and debug information output. 


Description 


1. .OUTPUT is the assembler directive that controls object module and debug information 


output. 


2. Ifthe OUTPUT directive is used two or more times in a program with inconsistent output 
specifiers, an error occurs. 


Example: 


.OUTPUT OBJ 
-OUTPUT NODBG 


~ 


168 HITACHI 


«OK 


~ 


-OUTPUT OBJ 
-OUTPUT NOOBJ 


~ 


< Error 


-OUTPUT 


3. Specifications concerning debug information output are only valid when an object module is 
output. 


4. To output debug information, the assembler automatically generates a directory with the 
name "dwfinf" under the directory to which the object file is output, and outputs a 
supplement debugging information file (ELF/DWARF supplement information) whose file 
name is the same as the object file and whose file format is "dwi". 


5. The assembler gives priority to command line option specifications concerning object module 
and debug information output. 


References: Object module output 
— User's Guide, 2.2.2, "Object Module Command Line Options" -OBJECT 
—NOOBJECT 


Debug information output 
— User's Guide, 2.2.2, "Object Module Command Line Options" -DEBUG 
—NODEBUG 


Coding Example 


Note: This example and its description assume that no command line options concerning object 
module or debug information output were specified. 


| - OUTPUT OBJ ; An object module is output. 
; No debug information is output. 


| 
. OUTPUT OBJ, DBG ; Both an object module and debug information 
; is output. 
- OUTPUT OBJ, NODBG ; An object module is output. 
; No debug information is output. 
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-OUTPUT 


Supplement: 


Debug information is required when debugging a program using the debugger, and is part of the 
object module. 


Debug information includes information about source statements and information about symbols. 
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- DEBUG 


Symbolic Debug Information Output Control 


Syntax 


.DEBUG <output specifier> 


Statement Elements 


1. 


Nw 


Label 

The label field is not used. 
Operation 

Enter the .DEBUG mnemonic. 
Operands: output specifier 


Output Specifier Output Control 


ON Symbolic debug information is output starting with the next 
source statement. 


OFF Symbolic debug information is not output starting with the next 
source statement. 


The shaded section indicates the default value when the specifier is omitted. 


The output specifier controls symbolic debug information output. 


Description 


Ls 


-DEBUG is the assembler directive that controls the output of symbolic debug information. 


This directive allows assembly time to be reduced by restricting the output of symbolic debug 
information to only those symbols required in debugging. 


The specification of the .DEBUG directive is only valid when both an object module and 
debug information are output. 
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- DEBUG 


References: Object module output 
— Programmer's Guide, 5.2.6, "Object Module Assembler Directives", 
OUTPUT 
— User's Guide, 2.2.2 "Object Module Command Line Options" 
—OBJECT —NOOBJECT 


Debug information output 

— Programmer's Guide 5.2.6, "Object Module Assembler Directives", 
OUTPUT 

— User's Guide, 2.2.2, "Object Module Command Line Options" 
—DEBUG —~NODEBUG 


Coding Example 
] 
. DEBUG OFF ; Starting with the next statement, the assembler 
; does not output symbolic debug information. 
. DEBUG ON ; Starting with the next statement, the assembler 
; outputs symbolic debug information. 
Supplement: 


The term "symbolic debug information" refers to the parts of debug information concerned with 
symbols. 
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- ENDIAN 


Endian Selection 


Syntax 


.-ENDIAN <endian> 


<endian>: {BIG|LITTLE} 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the ENDIAN mnemonic. 


3. Operands: endian 


Endian Output Control 
BIG Assembles program in big endian 
LITTLE Assembles program in little endian 


The shaded section indicates the default value when the specifier is omitted. _ 
Description 
1. .ENDIAN is the assembler directive that selects the big endian or little endian. 
2. Enter an .ENDIAN directive at the beginning of the source program. 
3. Ifthe -ENDIAN option has been specified, the ENDIAN is invalidated. 


Reference: —ENDIAN 
— User's Guide, 2.2.2 "Object Module Command Line Options" -ENDIAN 
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- ENDIAN 


Coding Example 


1. When the big endian is selected 


. CPU SH1 ; This statement specifies the SH1 as the CPU. | 
. ENDIAN BIG ; This statement selects the big endian. 
.DATA.L H'12345678 ; 

-DATA.W H'1234,H'5678 ; These statements reserve integer data. 
.DATA.B H'12,H'34 


__.,._—___ Mote: The data inthis igure 


is hexadecirral. 
4 Bytes 
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- ENDIAN 


2. When the little endian is selected 


. CPU SH3 ; This statement specifies the SH3 as the CPU. 
. ENDIAN LITTLE ; This statement selects the little endian. 
.DATA.L H'12345678 ; 

.DATA.W H'1234,H'5678 ; These statements reserve integer data. 
.DATA.B H'12,H'34 i 


es Note: The data in this igure 


is hexadecimal. 
4 Bytes 
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- LINE 


Line Number Modification 


Syntax 


.LINE ["<file name>",]<line number> 


Statement Elements 


1. 


Label 


The label field is not used. 


2. Operation 
Enter the .LINE mnemonic. 

3. Operands 
— First operand: file name 

Enter the file name referred to at error message output or at debugging. 
— Second operand: line number 
Enter the line number referred to at error message output or at debugging. 

Description 

1. .LINE is the assembler directive that changes the file name and line number referred to at 
error message output or at debugging. 

2. The line number and the file name specified with a .LINE directive is valid until the next 
-LINE. 

3. InaC Compiler of version 3.0 or higher, the .LINE directive that corresponds to the line 
number in the C source file is generated when the debug option is specified and an assembler 
source is output. 

4. Ifthe file name is omitted, the file name is not changed, but only the line number is changed. 
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. LINE 


Coding Example 


j+zi; 


Eehien tj); 


source program thertc) 


How (isi; i<=10;i+4)4 


sho -cCoderammcode -debuy teckh.c 


Assen Wy source program (test arc) 


PF Spe , ALIS =4 
“Jammsbeak.a' 1 
; funchim: ftwe 
; frame sizeso 
‘Jamsbeab.a" 3 
#0,F5 
“Jamsberk.a"  ¢€ 
#10,Ré6 
#1, Fa 


“faamsbeak.a' 7 
Rt, 

#1, Ft 
“Jasmsbeat.a" é 
Ré , Ft 

L2iz 
“Jasnsbeat.a",10 


“Jaamsbeak.a' > 
RS ,Fo 
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5.2.7 Assemble Listing Assembler Directives 


This assembler provides the following assembler directives for controlling the assemble listing. 


- PRINT 


- FORM 


- HEADING 


.- PAGE 


- SPACE 


Supplement: 


Controls assemble listing output. 


Controls the output of the source program listing. 


Sets the number of lines and columns in the assemble listing. 


Sets the header for the source program listing. 


Inserts a new page in the source program listing. 


Outputs blank lines to the source program listing. 


The assemble listing is a listing to which the results of the assembly are output, and includes a 
source program listing, a cross-reference listing, and a section information listing. 


Reference: For a detailed description of the assemble listing, see appendix C, "Assemble 
Listing Output Example". 
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- PRINT 


Assemble Listing Output Control 


Syntax 


.PRINT <output specifier>[,<output specifier>...] 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the PRINT mnemonic. 


3. Operands: output specifier 


Output Specifier Assembler Action 

LIST An assemble listing is output. 

NOLIST No assemble listing is output. 

SRO A source program listing is output in the assemble listing. 
NOSRC No source program listing is output in the assemble listing. 
CREF A cross-reference listing is output in the assemble listing. 
NOCREF No cross-reference listing is output in the assemble listing. 
SCT A section information listing is output in the assemble listing. 
NOSCT No section information listing is output in the assemble listing. 


The shaded sections indicate the default settings when the specifier is omitted. 


The output specifier controls assemble listing output. 
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- PRINT 


Description 


1. .PRINT is the assembler directive that controls assemble listing output. 


2. Ifthe .PRINT directive is used two or more times in a program with inconsistent output 
specifiers, an error occurs. 


Example: ~ 


~ ~ 


| 

| 

| .PRINT LIST | .PRINT LIST 
.PRINT NOSRC «OK .PRINT NOLIST < Error 


~ ~ 


3. The output specifiers concerned with the source program listing, the cross-reference listing, 
and the section information listing are only valid when an assemble listing is output. 


4. The assembler gives priority to command line option specifications concerning assemble 
listing output. 


References: Assemble listing output 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options" 
—LIST -NOLIST 
—SOURCE —NOSOURCE 
—CROSS_REFERENCE —NOCROSS_REFERENCE 
—SECTION —NOSECTION 


Coding Example 


Note: This example and its description assume that no command line options concerning 
assemble listing output are specified. 


. PRINT LIST ; All types of assemble listing are output. 
. PRINT LIST,NOSRC,NOCREF 


; Only a section information listing is output. 
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- LIST 


Source Program Listing Output Control 


Syntax 


-LIST <output specifier>[,<output specifier>...] 


Output specifier: {ON|OFF|COND|NOCOND|DEF|NODEF|CALL|NOCALL | 
EXP | NOEXP | CODE | NOCODE} 


Statement Elements 
1. Label 

The label field is not used. 
2. Operation 

Enter the .LIST mnemonic. 
3. Operands 

Enter the output specifiers. 
Description 


1. .LIST is the assembler directive that controls output of the source program listing in the 
following three ways: 


a Selects whether or not to output source statements. 


Selects whether or not to output source statements related to the conditional assembly 
and macro functions. 


c Selects whether or not to output object code lines. 
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- LIST 


2. Output is controlled by output specifiers as follows: 


Output Specifier 
Type Output Not output Object 


Description 


a ON OFF Source statements The source statements following this directive 
b COND NOCOND _ Failed condition Condition-failed .AIF or AIFDEF directive 
statements 
DEF NODEF Definition Macro definition statements 
-AREPEAT and .AWHILE definition statements 
.INCLUDE directive statements 
-ASSIGNA and .ASSSIGNC directive 
statements 
CALL NOCALL Call Macro call statements, 
-AIF, AIFDEF, and .AENDI directive statements 
EXP NOEXP Expansion Macro expansion statements 


-AREPEAT and .AWHILE expansion 
statements 


C CODE NOCODE Object code lines 


The object code lines exceeding the source 
statement lines 


The shaded sections indicate the default settings when the specifier is omitted. 


3. The specification of the .LIST directive is only valid when an assemble listing is output. 


References: Source program listing output 


— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 


.PRINT 


— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST -NOLIST -—SOURCE —NOSOURCE 


4. The assembler gives priority to command line option specifications concerning source 


program listing output. 


Reference: 


Output on the source program listing 


— User's Guide, 2.2.3, "Assemble Listing Command Line Options" 


-SHOW -—NOSHOW 


5. .LIST directive statements themselves are not output on the source program listing. 
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Coding Example 


- LIST 


SHIFT 


SHIFT 


SHIFT 


SHIFT 


SHIFT 


-LIST NOCOND,NODEF = -------- 
-MACRO SHLRN COUNT, Rd 


1 
' 
' 
' 

4 


-ASSIGNA \COUNT 


-AIF \&SHIFT GE 16 
SHLR16 \Rd 
-ASSIGNA \&SHIFT-16 
. AENDT 


-AIF \&SHIFT GE 8 
SHLR8 \Rd 
-ASSIGNA \&SHIFT-8 
- AENDI 


-AIF \&SHIFT GE 4 
SHLR2 \Rd 
SHLR2 \Rd 
-ASSIGNA \&SHIFT-4 
. AENDI 


-AIF \&SHIFT GE 2 
SHLR2 \Rd 
-ASSIGNA \&SHIFT-2 
. AENDI 


-AIF \&SHIFT GE 1 


SHLR \Rd 
. AENDI 
.ENDM eee 
SHLRN 23,RO  ———— seeeeeee 


This statement controls source program 


listing output. 


These statements define a general- 
purpose multiple-bit shift procedure as a 


macro instruction. 


Macro call 
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- LIST 


Source Listing Output of Coding Example 


The .LIST directive suppresses the output of the macro definition, .ASSIGNA and .ASSIGNC 
directive statements, and .AIF and .AIFDEF condition-failed statements. 


31 31 

32 32 SHLRN 23:;R0 
33 M 

35 M 

36 M -AIF 23 GE 16 
37 00000000 4029 Gc SHLR16 RO 
39 M - AENDI 

40 M 

41 M -AIF 7 GE 8 
45 M 

46 M -AIF 7 GE 4 
47 00000002 4009 Cc SHLR2 RO 
48 00000004 4009 Cc SHLR2 RO 
50 M . AENDTI 

5a M 

52 M -AIF 3 GE 2 
53 00000006 4009 c SHLR2 RO 
55 M - AENDI 

56 M 

57 M -AIF 1 GE 1 
58 00000008 4001 Cc SHLR RO 
59 M . AENDI 
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- FORM 


Assemble Listing Line Count and Column Count Setting 


Syntax 


.FORM <size specifier>[,<size specifier>...] 


Statement Elements 


1. 


Label 

The label field is not used. 
Operation 

Enter the FORM mnemonic. 
Operands: size specifier 


Size Specifier Listing Size 


LIN=<line count> The specified value is set to the number of lines per page. 
COL=<column count> The specified value is set to the number of columns per line. 


These specifications determine the number of lines and columns in the assemble listing. 


Description 


1. 


.FORM is the assembler directive that sets the number of lines per page and columns per line 
in the assemble listing. 


The line count and column count must be specified as follows: 


— The specifications must be absolute values, 
and, 


— Forward reference symbols must not appear in the specifications. 
The values allowed for the line count are from 20 to 255. 
The values allowed for the column count are from 79 to 255. 


The .FORM directive can be used any number of times in a given source program. 
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- FORM 


4. The assembler gives priority to command line option specifications concerning the number of 
lines and columns in the assemble listing. 


References: Setting the line count in assemble listing 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options" —LINES 


Setting the column count in assemble listing 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options" 
—COLUMNS 


5. When there is no specification of command line option or .FORM assembler directive 
specification for the line count or the column count, the following values are used: 


— Line count............. 60 lines 
— Column count........ 132 columns 
Coding Example 


Note: This example and its description assume that no command line options concerning the 
assemble listing line count and/or column count are specified. 


. FORM LIN=60, COL=200 ; Starting with this page, the number of lines 
; per page in the assemble listing is 60 lines. 
; Also, starting with this line, the number of 
; columns per line in the assemble listing is 
; 200 columns. 


. FORM LIN=55, COL=150 ; Starting with this page, the number of lines 
; per page in the assemble listing is 55 lines. | 
; Also, starting with this line, the number of 
; columns per line in the assemble listing is 


; 150 columns. 
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- HEADING 


Source Program Listing Header Setting 


Syntax 


| .HEADING "<character string>" 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the HEADING mnemonic. 
3. Operands: character string 
Enter the header for the source program listing. 
Description 
1. .HEADING is the assembler directive that sets the header for the source program listing. 
A character string of up to 60 characters can be specified as the header. 


Reference: Character strings 
— Programmer's Guide, 1.7, "Character Strings" 


2. The HEADING directive can be used any number of times in a given source program. 
The range of validity for a given use of the HEADING directive is as follows: 


— When the .HEADING directive is on the first line of a page, it is valid starting with that 
page. 

— When the .HEADING directive appears on the second or later line of a page, it is valid 
starting with the next page. 
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. HEADING 


Coding Example 


.» HEADING """SAMPLE.SRC"" WRITTEN BY YAMADA" 


“SSCPLE.Sk" HRITIEN BY YAILaDS 
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- PAGE 


Source Program Listing New Page Insertion 


Syntax 


. PAGE 


Statement Elements 
1. Label 

The label field is not used. 
2. Operation 

Enter the PAGE mnemonic. 
3. Operands 

The operand field is not used. 
Description 


1. .PAGE is the assembler directive that inserts a new page in the source program listing at an 
arbitrary point. 


N 


The .PAGE directive is ignored if it is used on the first line of a page. 


3. .PAGE directive statements themselves are not output to the source program listing. 
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- PAGE 


Coding Example 
MOV RO,RL1 
RTS 
MOV RO,R2 | 
. PAGE ; Anew page is specified here since the section changes at this point. | 


.SECTION DT,DATA,ALIGN=4 
-DATA.L 4H'11111111 
-DATA.L H'22222222 
.DATA.L H'33333333 | 


eee Depart RISC angire RSSEHELER Var. 4.0 £2 OafszsPs 1o:2b:30 
TROGRAH NAHE = 


OHO OO Or . PT, DATA, ALIGN 
OOOO 8 ddddidid . Ptidiidiii 
OOOO 8 RE : P2222 aes 
Coco oss BSSS> 55> . BPISSssttss 


Mote: See appends C, “faaemble Listing Guiput Example’, for an explanation of Ene combenks of the 
S0uras program lating. 
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- SPACE 


Source Program Listing Blank Line Output 


Syntax 


-SPACE[ <line count>] 


Statement Elements 


1. Label 


The label field is not used. 


i) 


Operation 
Enter the SPACE mnemonic. 
3. Operands: line count 
Enter the number of blank lines. 
A single blank line is output if this operand is omitted. 
Description 


1. .SPACE is the assembler directive that outputs the specified number of blank lines to the 
source program listing. Nothing is output for the lines output by the .SPACE directive; in 
particular line numbers are not output for these lines. 


2. The line count must be specified as follows: 


— The specification must be an absolute value, 
and, 


— Forward reference symbols must not appear in the specification. 
Values from | to 50 can be specified as the line count. 


3. When a new page occurs as the result of blank lines output by the SPACE directive, any 
remaining blank lines are not output on the new page. 


4. .SPACE directive statements themselves are not output to the source program listing. 
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- SPACE 


Coding Example 


- SECTION DT1, DATA, ALIGN=4 


.DATA.L H'11111111 

.DATA.L H'22222222 

.-DATA.L H' 33333333 

.DATA.L H'44444444 ; Inserts five blank lines at the point 
-SPACE 5 ; where the section changes. 


- SECTION DT2 , DATA, ALIGN=4 


OAfsiR ses 10:2> 30 


PPTi , DATA, ALIGH=4 
aidiiiii . MPtiiiiidiii 
SR See ae - A'22222222 
SSS55355 : A'SSsS sss 
rh eh . Dl tee ee 


Ife , DATA, ALIGH=4 


program lating. 
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5.2.8 Other Assembler Directives 


This assembler provides the following additional assembler directives. 


- PROGRAM 


Sets the name of the object module. 


- RADIX 


Sets the radix in which integer constants with no radix specifier are interpreted. 


.- END 


Declares the end of the source program. 
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- PROGRAM 


Object Module Name Setting 


Syntax 


. PROGRAM <object module name> 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the PROGRAM mnemonic. 
3. Operands: <object module name> 
Enter a name that identifies the object module. 
Description 
1. .PROGRAM is the assembler directive that sets the object module name. 


The object module name is a name that is required by the H Series Linkage Editor or the H 
Series Librarian to identify the object module. 


2. Object module naming conventions are the same as symbol naming conventions. 
The assembler distinguishes upper-case and lower-case letter in object module names. 


Reference: Coding of symbols 
— Programmer's Guide, 1.3.2, "Coding of Symbols" 


3. Setting the object module name with the PROGRAM directive is valid only once in a given 
program. (The assembler ignores the second and later specifications of the PROGRAM 
directive.) 
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- PROGRAM 


4. If there is no .PROGRAM specification of the object module name, the assembler will set a 
default (implicit) object module name. 


The default object module name is the file name of the object file (the object module output 
destination). 


Exanple: Object filename........... PROG? obj 7 


File nacre File format 


u 


Obect module nare..... PROG 


Reference: User's Guide, 1.2, "File Specification Format" 
5. The object module name can be the same as a symbol used in the program. 


Coding Example 


-PROGRAM PROG1 ; This statement sets the object module name to be 
; PROG1. 
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-RADIX 


Default Integer Constant Radix Setting 


Syntax 


-RADIX <radix specifier> 


Statement Elements 


1 


Label 


The label field is not used. 


2. Operation 
Enter the RADIX mnemonic. 
3. Operands: radix specifier 
Radix Specifier Radix of Integer Constants with No Radix Specification 
B Binary 
Q Octal 
D Decimal 
H Hexadecimal 
The shaded section indicates the default setting when the specifier is omitted. 
This specifier sets the radix (base) for integer constants with no radix specification. 
Description 
1. .RADIX is the assembler directive that sets the radix (base) for integer constants with no 
radix specification. 
2. When there is no radix specification with the .RADIX directive in a program, integer 
constants with no radix specification are interpreted as decimal constants. 
3. If hexadecimal (radix specifier H) is specified as the radix for integer constants with no radix 


specification, integer constants whose first digit is A through F must be prefixed with a 0 
(zero). (The assembler interprets expressions that begin with A through F to be symbols.) 
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. RADIX 


4. Specifications with the .RADIX directive are valid from the point of specification forward in 
the program. 


Coding Example 


. RADIX D 
X: . EQU 100 ; This 100 is decimal. 
. RADIX H 
Y: . EQU 64 ; This 64 is hexadecimal. 
| e = —— 7 
. RADIX H 
Z: . EQU OF ; A zero is prefixed to this constant "OF" since it would 


; be interpreted as a symbol if it were written as simply 
; "Pt. 
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. END 


Source Program End Declaration 


Syntax 


-END[ <start address>] 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the END mnemonic. 
3. Operands: start address 
Enter the start address for simulation if required. 
Description 
1. .END is the assembler directive that declares the end of the source program. 
Assembly processing terminates at the point that the .END directive appears. 


2. Ifastart address is specified with the .END directive in the operand field, the 
simulator/debugger starts simulation from that address. 


3. The start address must be specified with either an absolute value or an address value. 


4. The value of the start address must be an address in a code section. 
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- END 


Coding Example 


- EXPORT START 
- SECTION CD, CODE, ALIGN=4 
START: 


. END START ; This statement declares the end of the source 
; program. 


; The simulator/debugger starts simulation from the address indicated by the value of the 
; symbol START. 
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Section 6 File Inclusion Function 


The file inclusion function allows source files to be inserted into other source files at assembly 
time. The file inserted into another file is called an included file. 


This assembler provides the [INCLUDE directive to perform file inclusion. The file specified 
with the INCLUDE directive is inserted at the location of the INCLUDE directive. 


Example: 


Source program 


ee a a a a a ee 


Inch ded tik FILE. 


mY on, RO 


1 
1 
I 
I 
! 
1 
' 
1 
1 
1 
1 
1 
1 
1 
I 
L -SESTION SO {OLE ,SALIGH=4 
1 
1 
! IBY #on, ro 

1 

1 

1 

1 

1 

1 

1 

1 

1 

I 
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- INCLUDE 


File Inclusion 
eee 


Syntax 


. INCLUDE "<file name>" 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the INCLUDE mnemonic. 
3. Operands 
Enter the file to be included. 
Description 
1. INCLUDE is the file inclusion assembler directive. 


2. Ifno file format is specified, only the file name is used as specified (the assembler does not 
assume any default file format). 


Reference: User's Guide, 1.2, "File Specification Format" 


3. The file name can include the directory. The directory can be specified either by the absolute 
path (path from the route directory) or by the relative path (path from the current directory). 


Note: The current directory for the INCLUDE directive in a source file is the directory 
where the assembler is initiated. The current directory for the INCLUDE directive in 
an included file is the directory where the included file exits. 


4. Included files can include other files. The nesting depth for file inclusion is limited to 30 
levels (multiplex state). 


5. The directory name specified by INCLUDE can be changed by -INCLUDE. 


Reference: —-INCLUDE 
— User's Guide, 2.2.4, "File Inclusion Function Command Line Option" 


TEE ee 
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- INCLUDE 


Coding Example 


This example assumes the following directory configuration and operations: 


* Starts the assembler from the route 
directory (/) 
¢ Inputs source file /dirl/filel.sre 
dr 


¢ Inserts file2.h in filel.sre 


¢ Inserts file3.h in file2.h 


The start command is as follows: 
sasmsh /dirl/filel.src (RET) 


filel.src must have the following inclusion directive: 


.INCLUDE "dir2/file2.h" ; /is the current directory (relative path 
specification). 
or 
| . INCLUDE "/dir2/file2.h" ; Absolute path specification 
| _ _ — =, = = — 


_ file2.h must have the following inclusion directive: 
| . INCLUDE "file3.h" ; /dir2 is the current directory (relative path 
specification). 


or 


. INCLUDE "/dir2/file3.h"  ; Absolute path specification 
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- INCLUDE 


CAUTION! 


When using Windows®95 or Windows®NT, change the slash (/) in the above example as 
follows depending on the environment. 


¢ Japanese environment: Yen mark (¥) 
¢ English environment: Backslash (\) 
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Section 7 Conditional Assembly Function 


7.1 Overview of the Conditional Assembly Function 


The conditional assembly function provides the following assembly operations: 


* Replaces a character string in the source program with another character string. 


¢ Selects whether or not to assemble a specified part of a source program according to the 
specified condition. 


¢ Iteratively assembles a specified part of a source program. 


7.1.1. Preprocessor variables 


Preprocessor variables are used to write assembly conditions. Preprocessor variables are of either 
integer or character type. 


1. Integer preprocessor variables 


Integer preprocessor variables are defined by the .ASSIGNA directive (these variables can be 
redefined). 


When referencing integer preprocessor variables, insert a backslash (\)* and an ampersand 
(&) in front of them. 


Example: 


FLAG: .ASSIGNA 1 


.AIF \&FLAG EQ 1 ; MOV RO,R1 is assembled 
MOV RO,R1 ; when FLAG is 1. 
. AENDI 


Note: When using a Japanese environment, use ¥ instead of \. 
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2. Character preprocessor variables 


Character preprocessor variables are defined by the .ASSIGNC directive (these variables can 
be redefined). 


When referencing character preprocessor variables, insert a backslash (\)* and an ampersand 
(&) in front of them. 


Example: 


FLAG: .ASSIGNC "ON" 


-AIF "\&FLAG" EQ "ON" ; MOV RO,R1 is assembled 
MOV RO,R1 ; when FLAG is "ON". 
. AENDI 


Note: When using a Japanese environment, use ¥ instead of \. 


7.1.2 Replacement Symbols 


The .DEFINE directive specifies symbols that will be replaced with the corresponding character 
strings at assembly. A coding example is shown below. 


Example: 
SYM1: .DEFINE "Ri" 
MOV.L SYM1,R0 ; Replaced with MOV.L R1,RO0. 
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7.1.3 Conditional Assembly 


The conditional assembly function determines whether or not to assemble a specified part of a 
source program according to the specified conditions. Conditional assembly is classified into two 
types: conditional assembly with comparison using relational operators and conditional assembly 
with definition of replacement symbols. 


Conditional Assembly with Comparison: 


Selects the part of program to be assembled according to whether or not the specified condition is 
satisfied. A coding example is as follows: 


AIF «comparison condition 1» 
~Strement tobe assembled when condidion 4 is satsted. 
ABLIF «comparison condition?» i | 
1 
| «otatement tobe assembled when condition 2is saisied. 
|. KELSE : 
| « Statenents 10 be assembled when both conditions arenot satsted= | 
“Mar [ aia ° | 
| 
a ' This part can be omitted. | 
Example: 
-AIF "\&FLAG" EQ "ON" 
MOV RO,R10 ; Assembled when FLAG 
MOV R1,R11 ; is ON. 
MOV R2,R12 i 
. AELSE 
MOV R10,R0 ; Assembled when FLAG 
MOV R11,R1 ; is not ON. 
MOV R12,R2 ; 
. AENDI 


_— 
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Conditional Assembly with Definition: 


Selects the part of program to be assembled by whether or not the specified replacement symbol 
has been defined. A coding example is as follows: 


-ADFIEF «definition cormitiom 
<Staememns tobe assembled when the specdfied rclacement symbol is defined» 
el i aa i 
{_<Statements tobe assembled when the specified replacement symbel is notdefineds | 
SEHOC 
Se L__This Pa rtcan be omitted. 
| 
Example: 
-AIFDEF FLAG 
MOV RO,R10 ; Assembled when FLAG is defined with 
MOV R1,R11 ; the .DEFINE directive before the .AIFDEF 
MOV R2,R12 ; directive in the program. 
. AELSE | 
MOV R10,RO0 ; Assembled when FLAG is not defined with 
MOV R11,R1 ; the .DEFINE directive before the .AIFDEF 
MOV R12,R2 ; directive in the program. 
AENDI | 
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7.1.4 Iterated Expansion 


A part of a source program can be iteratively assembled the specified number of times. A coding 


example is shown below. 


~~ 


-AREPEAT <count> 


<Statements to be iterated> 


. AENDR 
Example: 

; This example is a division of 64-bit data by 32-bit data. 
| ; R1:R2 (64 bits) + RO (32 bits) = R2 (32 bits): Unsigned 
| TST RO, RO ; Zero divisor check 

BT zero div 


CMP/HS RO,R1 
Br over div 
DIVOU 
-AREPEAT 32 
ROTCL R2 


DIV1 RO,R1 
| . AENDR 
ROTCL R2 


se 


Overflow check 


Flag initialization 


These statements are iteratively assembled 32 times. 


R2 = quotient 
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7.1.5 Conditional Iterated Expansion 


A part of a source program can be iteratively assembled while the specified condition is satisfied. 
A coding example is shown below. 


—_ 


.AWHILE <condition> | 


<Statements to be iterated> 


. AENDW 
Example: 
; This example is a multiply and accumulate | 
; Operation. 
Tb1Siz: .ASSIGNA 50 ; TblSiz: Data table size 
MOV A Thli,RL ; Rt1: Start address of data table 1 
MOV A_Tb12,R2 ; R2: Start address of data table 2 
CLRMAC ; MAC register initialization 
. AWHILE \&Tb1Siz GT 0 ; While TblSiz is larger than 0, 
MAC .W @RO+,@R1+ ; this statement is iteratively assembled. 
Tb1Siz: .-ASSIGNA \&Tbl1Siz-1 ; 1is subtracted from TblSiz. 
. AENDW | 
STS MACL, RO ; The result is obtained in RO. | 
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Tz Conditional Assembly Directives 


This assembler provides the following conditional assembly directives. 


-ASSIGNA 


-ASSIGNC 


- DEFINE 


-AIF 


- AELIF 


- AELSE 


- AENDI 


-AIFDEF 


- AELSE 


- AENDI 


- AREPEAT 


- AENDR 


- AWHILE 


- AENDW 


- AERROR 


- EXITM 


-ALIMIT 


Defines an integer preprocessor variable. The defined variable 
can be redefined. 


Defines a character preprocessor variable. The defined variable 
can be redefined. 


Defines a preprocessor replacement character string. 


Determines whether or not to assemble a part of a source program 
according to the specified condition. When the condition is 
satisfied, the statements after the .AIF are assembled. When not 
satisfied, the statements after the .AELIF or .AELSE are 
assembled. 


Determines whether or not to assemble a part of a source program 
according to the replacement symbol definition. When the 
replacement symbol is defined, the statements after the .AIFDEF 
are assembled. When not defined, the statements after the 
-AELSE are assembled. 


Repeats assembly of a part of a source program (between 
-AREPEAT and .AENDR) the specified number of times. 


Assembles a part of a source program (between .AWHILE and 
-AENDW) iteratively while the specified condition is satisfied. 


Processes an error during preprocessor expansion. 


Terminates .AREPEAT or .AWHILE iterated expansion. 


Specifies the maximum count of .AWHILE expansion. 
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-ASSIGNA 


Integer Preprocessor Variable Definition (Redefinition Is Possible) 


Syntax 


<preprocessor variable>[:] .ASSIGNA <value> 


Statement Elements 
1. Label 
Enter the name of the preprocessor variable. 
2. Operation 
Enter the AASSIGNA mnemonic. 
3. Operands 
Enter the value to be assigned to the preprocessor variable. 
Description 


1. .ASSIGNA is the assembler directive that defines a value for an integer preprocessor 
variable. The syntax of integer preprocessor variables is the same as that for symbols. An 
integer preprocessor variable can be defined with up to 32 characters, and uppercase and 
lowercase letters are distinguished. 


2. The preprocessor variables defined with the .ASSIGNA directive can be redefined with the 
.ASSIGNA directive. 


3. The values for the preprocessor variables must be the following: 


— Constant (integer constant and character constant) 
— Defined preprocessor variable 


— Expression using the above as terms 


4. Defined preprocessor variables are valid from the point of specification forward in the source 
program. 
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-ASSIGNA 


Defined preprocessor variables can be referenced in the following locations: 


— .ASSIGNA directive 

— .ASSIGNC directive 

— .AIF directive 

— .AELIF directive 

— .AREPEAT directive 

— .AWHILE directive 

— Macro body (source statements between .MACRO and .ENDM) 


When referencing integer preprocessor variables, insert a backslash (\)* and an ampersand 
(&) in front of them. 


\&<preprocessor variable>['] 


To clearly distinguish the preprocessor variable name from the rest of the source statement, 
an apostrophe (') can be added. 


Note: When using a Japanese environment, use ¥ instead of \. 
When a preprocessor character string is defined by a command line option, the ASSIGNA 


directive specifying the preprocessor variable having the same name as the character string 
is invalidated. 
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-ASSIGNA 


Coding Example 
; This example generates a general-purpose multiple-bit 
; shift instruction which shifts bits to the right by the 
; number of SHIFT. 
RN: .REG (RO) ; ROis set to Rn. 
SHIFT: .ASSIGNA 27 ; 27 is set to SHIFT. 
.AIF \&SHIFT GE 16 ; Condition: SHIFT 16 
SHLR16 Rn ; When the condition is satisfied, Rn is shifted to the right by 16 bits. 
SHIFT: .ASSIGNA \&SHIFT-16 ; 16 is subtracted from SHIFT. 
. AENDI 
-AIF \&SHIFT GE 8 ; Condition: SHIFT 8 
SHLR8 Rn ; When the condition is satisfied, Rn is shifted to the right by 8 bits. 
SHIFT: .ASSIGNA \&SHIFT-8 ; 8 is subtracted from SHIFT. 
. AENDI 
-AIF \&SHIFT GE 4 ; Condition: SHIFT 4 
SHLR2 Rn ; When the condition is satisfied, Rn is shifted to the right by 4 bits. 
SHLR2 Rn i 
SHIFT: .ASSIGNA \&SHIFT-4 ; 4 is subtracted from SHIFT. 
. AENDI 
.AIF \&SHIFT GE 2 ; Condition: SHIFT 2 
SHLR2 Rn ; When the condition is satisfied, Rn is shifted to the right by 2 bits. 
SHIFT: .ASSIGNA \&SHIFT-2 ; 2is subtracted from SHIFT. 
. AENDI 
-AIF \&SHIFT EQ 1 ; Condition: SHIFT = 1 
SHLR Rn ; When the condition is satisfied, Rn is shifted to the right by 1 bit. 
. AENDI 


The expanded results are as follows: 


SHLR16 RO ; When the condition is satisfied, Rn is shifted to the right by 16 bits. 
SHLR8 RO ; When the condition is satisfied, Rn is shifted to the right by 8 bits. 
SHLR2 RO ; When the condition is satisfied, Rn is shifted to the right by 2 bits. 
SHLR RO ; When the condition is satisfied, Rn is shifted to the right by 1 bit. 
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.ASSIGNC | 


Character Preprocessor Variable Definition (Redefinition Is Possible) 


Syntax 


<preprocessor variable>[:] .ASSIGNC "<character string>" 


— j 


Statement Elements 
1. Label 
Enter the name of the preprocessor variable. 
2. Operation 
Enter the .ASSIGNC mnemonic. 
3. Operands 
Enter the character string enclosed with double quotation marks ("). 
Description 


1. .ASSIGNC is the assembler directive that defines a character string for a character 
preprocessor variable. The syntax of character preprocessor variables is the same as that for 
symbols. A character preprocessor variable can be defined with up to 32 characters, and 
uppercase and lowercase letters are distinguished. 


2. The preprocessor variables defined with the .ASSIGNC directive can be redefined with the 
.ASSIGNC directive. 


3. Character strings are specified by characters or preprocessor variables enclosed with double 
quotation marks ("). 


4. Defined preprocessor variables are valid from the point of specification forward in the source 
program. 


5. Defined preprocessor variables can be referenced in the following locations: 


— .ASSIGNA directive 
— .ASSIGNC directive 
— .AIF directive 

— .AELIF directive 
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-ASSIGNC 


— .AREPEAT directive 
— .AWHILE directive 
— Macro body (source statements between .MACRO and .ENDM) 


When referencing character preprocessor variables, insert a backslash (\)* and an ampersand 
(&) in front of them. 


\&<preprocessor variable>['] 


To clearly distinguish the preprocessor variable name from the rest of the source statement, 
an apostrophe (') can be added. 


Note When using a Japanese environment, use ¥ instead of \. 


6. When a preprocessor character string is defined by a command line option, the .ASSIGNC 
directive specifying the preprocessor variable having the same name as the character string 
is invalidated. 


Coding Example 
FLAG: .ASSIGNC "ON" ; "ON" is set to FLAG. 


.AIF "\&FLAG" EQ "ON" ; MOV RO,R1 is assembled 


MOV RO,R1 ; when FLAG is "ON". 

. AENDI 
FLAG: .ASSIGNC "\&FLAG " ; Aspace ("") is added to FLAG. 
FLAGA: .ASSIGNC "OFF" ; "OFF" is added to FLAGA. 


FLAG: .ASSIGNC "\&FLAG'AND \&FLAGA" 
; An apostrophe (') is used to distinguish FLAG and 
; AND. 
; FLAG finally becomes "ON AND OFF". 


216 HITACHI 


- DEFINE 


Definition of Preprocessor Replacement Character String 


Syntax 


<symbol>[:] .DEFINE "<replacement character string>" 


Statement Elements 
1. Label 
Enter a symbol to be replaced with a character string. 
2. Operation 
Enter the .DEFINE mnemonic. 
3. Operands 
Enter a character string to replace the symbol, enclosed with double quotation marks ("). 
Description 


1. .DEFINE is the assembler directive that specifies that the symbol is replaced with the 
corresponding character string. 


2. The differences between the .DEFINE directive and the .ASSIGNC directive are as follows. 


— The symbol defined by the .ASSIGNC directive can only be used in the preprocessor 
statement; the symbol defined by the .DEFINE directive can be used in any statement. 

— The symbols defined by the .ASSIGNA and the .ASSIGNC directives are referenced by 
the "\&symbol" format; the symbol defined by the .DEFINE directive is referenced by the 
"symbol" format. 

— The .DEFINE symbol cannot be redefined. 


3. The .DEFINE directive specifying a symbol is invalidated when the same replacement 
symbol has been defined by a command line option. 
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- DEFINE 


Coding Example 
SYM1: .DEFINE "Ri" 
MOV .L SYM1, RO ; Replaced with MOV.L R1,RO0. 
Notes 


L. 


A hexadecimal number starting with an alphabetical character a to f or A to F will be 
replaced when the same character string is specified as a replacement symbol by .DEFINE 
directive. Add 0 to the beginning of the number to stop replacing such number. 


AO: .DEFINE "0" 
MOV.B #H'AO,RO ; Replaced with MOV.B #H'0,RO. 
MOV.B #H'OAO, RO ; Not replaced. 


A radix indication (B', Q', D', or H') will also be replaced when the same character string is 
specified as a replacement symbol by .DEFINE directive. When specifying a symbol having 
only one character, such as B, Q, D, H, b, q, d, or h, make sure that the corresponding radix 
indication is not used. 


B .DEFINE "H" 
MOV.B #B'10,RO0 ; Replaced with MOV.H #H'10,RO. 
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-AIF - AELIF -AELSE - AENDI 


Conditional Assembly with Comparison 


Syntax 


| &. ADA aterm arelational operator 4 hem oe 
Soros shatemants assembled if the SIF comlition is mtistieds 
SELIM «termladarelational operators d¢<termes 
| | Somos shatenents assembled if the AELIF condition is mtisfiod 
‘4. &ELSE 


aSource shatements asaembled if all the conditions: are not eee 
4. SE HOT 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the .AIF, .AELIF (can be omitted), .AELSE (can be omitted), or .AENDI mnemonic. 
3. Operands 


.AIF: Enter the condition. Refer to the description below. 
.AELIF: Enter the condition. Refer to the description below. 
.AELSE: The operand field is not used. 

.AENDI: The operand field is not used. 


Description 
1. .AIF, .AELIF, .AELSE, and .AENDI are the assembler directives that select whether or not 
to assemble source statements according to the condition specified. The .AELIF and .AELSE 


directives can be omitted. 


2. .AELIF can be specified repeatedly between .AIF and .AELSE. 
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-AIF - AELIF - AELSE - AENDI 


3. The condition must be specified as follows: 


-AIF <terml> <relational operator> <term2> 
-AELIF <terml> <relational operator> <term2> 


Terms are specified with numeric values or character strings. However, when a numeric 
value and a character string are compared, the condition always fails. 


Numeric values are specified by constants or preprocessor variables. 


Character strings are specified by characters or preprocessor variables enclosed with double 
quotation marks ("). To specify a double quotation mark in a character string, enter two 
double quotation marks in succession. 


4. The following relational operators can be used: 


EQ: terml = term2 
NE: terml term2 
GT: terml > term2 
LT: terml < term2 
GE: terml term2 
LE: terml term2 


Note: Numeric values are handled as 32-bit signed integers. For character strings, only EQ and 
NE conditions can be used. 
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-AIF - AELIF - AELSE - AENDI 


Coding Example 


-AIF \&TYPE EQ 1 


MOV RO,R3 ; These statements 

MOV R1,R4 ; are assembled | 
MOV R2,R5 ; when TYPE is 1. | 
-AELIF \&TYPE EQ 2 | 
MOV RO,R6 ; These statements | 

| MOV R1,R7 ; are assembled 

MOV R2,R8 ; when TYPE is 2. 

. AELSE 

MOV RO,R9 ; These statements 

MOV R1,R10 ; are assembled | 
MOV R2,R11 ; when TYPE is not 1 nor 2. | 
. AENDI | 


HITACHI 221 


. AIFDEF - AELSE - AENDI 


Conditional Assembly with Definition 


Syntax 


‘APD la abo | 


<xbaAbeenka bo be auxcenbled whem the apecigied meplacemant ayabol ia define 


A. AELZE 
<xhAReREA bo be ankenbled he. Che apecigied replacement apabeol ia mok daft ine- 
4.,.AEMDI 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the .AIFDEF, .AELSE (can be omitted), or .AENDI mnemonic. 
3. Operands 


.AIFDEF: Enter the condition. Refer to the description below. 
.AELSE: The operand field is not used. 
.AENDI: The operand field is not used. 


Description 


1. .AIFDEF, .AELSE, and .AENDI are the assembler directives that select whether or not to 
assemble source statements according to the replacement symbol definition. 


2. The condition must be specified as follows. 
.AIFDEF <replacement symbol> 
The replacement symbol must be defined by the .DEFINE directive. 


When the specified replacement symbol is defined by the command line option or in the 
source statements before this directive, the condition is regarded as satisfied. When the 


replacement symbol is defined after this directive or is not defined, the condition is regarded 
as unsatisfied. 
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- AIFDEF - AELSE - AENDI 


Coding Example 

. AIFDEF FLAG 

MOV RO,R3 ; These statements are assembled when 
MOV R1,R4 ; FLAG is defined by .DEFINE directive. 

. AELSE 

MOV RO,R6 ; These statements are assembled when 
MOV R1,R7 ; FLAG is not defined by .DEFINE directive. 
AENDI 
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- AREPEAT - AENDR 


Iterated Expansion 


Syntax 


.AREPEAT <count> 


<Source statements iteratively assembled> 


. AENDR 


Statement Elements 


1. Label 
The label field is not used. 

2. Operation 
Enter the .AREPEAT or .AENDR mnemonic. 

3. Operands 
-AREPEAT: Enter the number of iterations. 

-AENDR: The operand field is not used. 

Description 

1. .AREPEAT and .AENDR are the assembler directives that assemble source statements by 
iteratively expanding them the specified number of times. 

2. The source statements between the .AREPEAT and .AENDR directives are iterated the 
number of times specified with the .AREPEAT directive. Note that the source statements are 
simply copied the specified number of times, and therefore, the operation is not a loop at 
program execution. 

3. Counts are specified by constants or preprocessor variables. 

4. Nothing is expanded if a value of 0 or smaller is specified. 
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Coding Example 


- AREPEAT - AENDR 


TST 
BT 
CMP/HS 

BT 

DIVOU 

. AREPEAT 
ROTCL 
DIV1 

. AENDR 

ROTCL 


RO,RO 
zero div 
RO,R1 


over div 
32 
R2 


RO,R1 


R2 


~ 


; This example is a division of 64-bit data by 32-bit data. 
; R1:R2 (64 bits) + RO (32 bits) = R2 (32 bits): Unsigned 
; Zero divisor check 


Overflow check 


Flag initialization 


These statements are 
iterated 32 times. 


R2 = quotient 
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- AWHILE - AENDW 


Conditional Iterated Expansion 


Syntax 


| 
.AWHILE <terml> <relational operator> <term2> | 
<Source statements iteratively assembled> 
. AENDW 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the .AWHILE or .AENDW mnemonic. 
3. Operands 


AWHILE: Enter the condition to iteratively expand source statements. 
.AENDW: The operand field is not used. 


Description 


1. .AWHILE and .AENDW are the assembler directives that assemble source statements by 
iteratively expanding them while the specified condition is satisfied. 


2. The source statements between the .AWHILE and .AENDW directives are iterated while the 
condition specified with the .AWHILE directive is satisfied. Note that the source statements 
are simply copied iteratively, and therefore, the operation is not a loop at program execution. 


3. The condition must be specified as follows: 
.-AWHILE <terml> <relational operator> <term2> 


Terms are specified with numeric values or character strings. However, when a numeric 
value and a character string are compared, the condition always fails. 
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| . AWHILE | . AENDW | 


Numeric values are specified by constants or preprocessor variables. 


Character strings are specified by characters or preprocessor variables enclosed with double 
quotation marks ("). To specify a double quotation mark in a character string, enter two 


double quotation marks ( 


woe 


) in succession. 


Conditional iterated expansion terminates when the condition finally fails. 


CAUTION! 


If a condition which never fails is specified, source statements are iteratively expanded for 65,535 
times or until the maximum count of statement expansion specified by the .ALIMIT directive is 


reached 


. Accordingly, the condition for this directive must be carefully specified. 


4. The following relational operators can be used: 


EQ: 
NE: 
GT: 
LT: 
GE: 
LE: 


Note: 


term] = term2 
terml term2 
terml > term2 
term1 < term2 
terml term2 
terml term2 


Numeric values are handled as 32-bit signed integers. For character strings, only EQ and 
NE conditions can be used. 
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- AWHILE - AENDW 


Coding Example 
; This example is a multiply and accumulate 
; Operation. 
Tb1Siz: .ASSIGNA 50 ; TblSiz: Data table size 

MOV A_Tbl1,R1 ; R1: Start address of data table 1 

MOV A_Tb12,R2 ; R2: Start address of data table 2 

CLRMAC ; MAC register initialization 

. AWHILE \&Tb1Siz GT 0 ; While TblSiz is larger than 0, 

MAC .W @RO+,@R1+ ; this statement is iteratively assembled. 


Tb1Siz: .ASSIGNA \&Tbl1Siz-1 1 is subtracted from TblSiz. 


- AENDW 


~ 


STS MACL, RO The result is obtained in RO. 


“ee 
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- AERROR 


Error Generation During Preprocessor Expansion 


Syntax 


. AERROR 


Statement Elements 
1. Label 

The label field is not used. 
2. Operation 

Enter the .AERROR mnemonic. 
3. Operands 

The operand field is not used. 
Description 


1. When the .AERROR directive is assembled, error 667 is generated and the assembler is 
terminated with an error. 


2. The .AERROR directive can be used to check values such as preprocessor variables. 
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- AERROR 


Coding Example 


.AIF \&FLG EQ 1 
MOV R1,R10 | 
MOV R2,R11 
. AELSE 

. AERROR ; When \&FLG is not 1, an error is generated. 
. AENDI 
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- EXITM 


Expansion Termination 


Syntax 


. EXITM 


Statement Elements 
1. Label 

The label field is not used. 
2. Operation 

Enter the .EXITM mnemonic. 
3. Operands 

The operand field is not used. 
Description 


1. .EXITM is the assembler directive that terminates an iterated expansion (.AREPEAT to 
.-AENDR) or a conditional iterated expansion (.AWHILE to .AENDW). 


2. Each expansion is terminated when this directive appears. 


3. This directive is also used to exit from macro expansions. The location of this directive must 
be specified carefully when macro instructions and iterated expansion are combined. 


Reference: Macro expansion 
— Programmer's Guide, 8.2, "Macro Function Directives" 
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- EXITM 


Coding Example 

COUNT .ASSIGNA 0 ; Ois set to COUNT. 

-AWHILE 1 EQ 1 ; An infinite loop (condition is always satisfied) is 
; specified. 

ADD RO,R1 
ADD R2,R3 

COUNT .ASSIGNA \&COUNT+1 ; 1is added to COUNT. 
.AIF \&COUNT EQ 2. ; Condition: COUNT = 2 
. EXITM ; When the condition is satisfied 
. AENDI ; -AWHILE expansion is terminated. 
AENDW 


assembled. When .EXITM is assembled, .AWHILE expansion is terminated. 


The expansion results are as follows: 


ADD RO, RI scscccesvevcusceseves When COUNT is 0 
ADD R2,R3 
ADD RO, RL vereseeetseneevsessens When COUNT is 1 
ADD R2,R3 


After this, COUNT becomes 2 and expansion is terminated. 


When COUNT is updated and satisfies the condition specified with the .AIF directive, .EXITM is 
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.ALIMIT | 


Maximum Count Specification for .AWHILE Expansion in Preprocessor 


Syntax 


-ALIMIT <count> 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the .ALIMIT mnemonic. 
3. Operands 
Enter the maximum count of statement expansion. 
Description 


1. During conditional iterated (AWHILE to .AENDW) expansion, if the statement expansion 
count exceeds the maximum value specified by the .ALIMIT directive, warning 854 is 
generated and the expansion is terminated. 


2. Ifthe .ALIMIT directive is not specified, the maximum count is 65,535. 


HITACHI 233 


-ALIMIT 


Coding Example 
. ALIMIT 20 
FLG: .ASSIGNA 0 
. AWHILE \&FLG EQ 0 ; Expansion is terminated after performed 
NOP ; 20 times, and a warning message is output. 
AENDW 
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Section 8 Macro Function 


8.1 Overview of the Macro Function 


The macro function allows commonly used sequences of instructions to be named and defined as 
one macro instruction. This is called a macro definition. Macro instructions are defined as 
follows: 


~~ 


.MACRO <macro name> 
<macro body> 
. ENDM 


~~ 


A macro name is the name assigned to a macro instruction, and a macro body is the statements to 
be executed as the macro instruction. 


Using a defined macro instruction by specifying the name is called a macro call. Macro 
instructions are called as follows: 


~~ 


<defined macro name> 


~~ 


An example of macro definition and macro call is shown below. 


Example: 


— 

-MACRO SUM 
MOV RO,R10 
ADD R1,R10 


Processing to obtain the sum of RO, R1, R2, 
and R3 is defined as macro instruction SUM. 


ADD R2,R10 
ADD R3,R10 
. ENDM | 
~~ | 
SUM ; This statement calls macro instruction SUM. 

; Macro body MOV RO,R10 

; ADD R1,R10 

; ADD R2,R10 

; ADD R3,R10 


is expanded from the macro instruction. 


HITACHI 235 


Parts of the macro body can be replaced when expanded by the following procedure: 
1. Macro definition 


a. Declare formal parameters after the macro name in the MACRO directive. 


b. Use the formal parameters in the macro body. Formal parameters must be identified in 
the macro body by placing a backslash (\) in front of them. 


2. Macro call 
Specify macro parameters in the macro call. 


When the macro instruction is expanded, the formal parameters are replaced with their 
corresponding macro parameters. 


Example: 
-MACRO SUM ARG1 ; Formal parameter ARG1 is defined. 
MOV RO, \ARG1 ; ARG‘1 is referenced in the macro body. 


ADD R1,\ARG1 
ADD R2,\ARG1 
ADD R3,\ARG1 


SUM R10 ; This statement calls macro instruction SUM 
; specifying macro parameter R10. 
; The formal parameter in the macro body is 
; replaced with the macro parameter, and 
; MOV RO,R10 
i ADD R1,R10 
; ADD R2,R10 
F ADD R3,R10 is expanded. 
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8.2 Macro Function Directives 


This assembler provides the following macro function directives. 


- MACRO | Defines a macro instruction. 
ENDM | 
. EXITM Terminates macro instruction expansion. 
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- MACRO - ENDM 


Macro Definition 


Syntax 


.MACRO <macro name>[ <formal parameter>[=<default>] | 
[,<formal parameter>...]] | 
. ENDM | 


Statement Elements 
1. Label 
The label field is not used. 
2. Operation 
Enter the .MACRO or .ENDM mnemonic. 
3. Operands 


.MACRO: Enter the name and formal parameters (can be omitted) for the macro instruction 
to be defined. When formal parameters are defined, their defaults can be defined 
(defaults can be omitted). 

.ENDM: _ The operand filed is not used. 


Description 


1. .MACRO and .ENDM are the assembler directives that define a macro instruction (a 
sequence of source statements that are collectively named and handled together). 


2. Macro definition 


Naming as a macro instruction the source statements (macro body) between the MACRO 
and .ENDM directives is called a macro definition. 


3. Macro name 


Macro names are the names assigned to macro instructions. 
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- MACRO - ENDM 


Formal parameters 


Formal parameters are specified so that parts of the macro body can be replaced by specific 
parameters at expansion time. Formal parameters are replaced with the character strings 
(macro parameters) specified at macro expansion (macro call). 


— Formal parameter syntax 


The syntax for formal parameters is the same as that for symbols. A formal parameter 
can be defined with up to 32 characters, and uppercase and lowercase letters are 
distinguished. 


— Formal parameter reference 


Formal parameters are used (referenced) at the part to be replaced in the macro body. 


The syntax of formal parameter reference in macro bodies is as follows: 


* 


\<formal parameter name>['] 


To clearly distinguish the formal parameter name from the rest of the source statement, 
an apostrophe (') can be added. 


Note: When using a Japanese environment, use ¥ instead of \. 
Formal parameter defaults 


Defaults for formal parameters can be specified in macro definitions. The default specifies 
the character string to replace the formal parameter when the corresponding macro 
parameter is omitted in a macro call. 


The default must be enclosed with double quotation marks (") or angle brackets (<>) if any 
of the following characters are included in the default. 


— Space 

— Tab 

— Comma (,) 

— Semicolon (;) 

— Double quotation marks (") 
— Angle brackets (<>) 


The assembler inserts defaults at macro expansion by removing the double quotation marks 
or angle brackets that enclose the character strings. 
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- MACRO - ENDM 
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- MACRO - ENDM | 


6. Restrictions on macro definitions 


— Macros cannot be defined in the following locations: 
* Macro bodies (between .MACRO and .ENDM directives) 
* Between .AREPEAT and .AENDR directives 
* Between .AWHILE and .AENDW directives 

— The .END directive cannot be used within a macro body. 


— No symbol can be inserted in the label field of the IENDM directive. The ENDM 
directive is ignored if a symbol is written in the label field, but no error is generated in 


this case. 
Coding Example 
-MACRO SUM ; Processing to obtain the sum of RO, R1, R2, 
MOV RO,R10 ; and R3 is defined as macro instruction SUM. 


ADD R1,R10 
ADD R2,R10 
| ADD R3,R10 


. ENDM 
SUM ; This statement calls macro instruction SUM 
| ; Macro body MOV RO,R10 
| ; ADD R1,R10 


| ; ADD R2,R10 
; ADD R3,R10 is expanded. 
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- EXITM 


Expansion Termination 


Syntax 


.EXITM | 


Statement Elements 
1. Label 

The label field is not used. 
2. Operation 

Enter the .EXITM mnemonic. 
3. Operands 

The operand field is not used. 
Description 


1. .EXITM is the assembler directive that terminates a macro expansion. This directive can be 
specified within the macro body (between the .MACRO and .ENDM directives). 


2. Expansion is terminated when this directive appears. 


3. This directive is also used to exit from iterated expansions specified with the .AREPEAT or 
AWHILE directive. The location of this directive must be specified carefully when macro 
instructions and iterated expansion are combined. 
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- EXITM 


Coding Example 


MACRO «SUM Pl 
Moy RO, R10 


ADD R1, R10 i (1) 
| ADD h2 , R10 : 
| SPL ween nnnns (2) 
ADD BS, R10 
| .EHDM 
SUM EIT | 


EXITM is expanded at [2] and macro expansion is terminated. Only the statements indicated 
by [1] are espanded. 
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8.3. Macro Body 


The source statements between the MACRO and .ENDM directives are called a macro body. The 
macro body is expanded and assembled by a macro call. 


1. Formal parameter reference 


Formal parameters are used to specify the parts to be replaced with macro parameters at 
macro expansion. 


The syntax of formal parameter reference in macro bodies is as follows: 
* 


\<formal parameter name>['] 


To clearly distinguish the formal parameter name from the rest of the source statement, add 
an apostrophe (’). 


Note: When using a Japanese environment, use ¥ instead of \. 


Coding example: 


-MACRO PLUS1 P,P1 ; P and P1 are formal parameters. 
ADD #1,\PL1 ; Formal parameter P1 is referenced. 
.SDATA "\P!'1" ; Formal parameter P is referenced. 
. ENDM 

PLUS1 R,R1 ; PLUS1 is expanded. 


Expanded results are as follows: 


ADD #1,R1 ; Formal parameter P71 is referenced. 
.SDATA "R11" ; Formal parameter P is referenced. 


2. Preprocessor variable reference 
Preprocessor variables can be referenced in macro bodies. 
The syntax for preprocessor variable reference is as follows: 
* 


\&<preprocessor variable name>['] 


To clearly distinguish the preprocessor variable name from the rest of the source statement, 
add an apostrophe (’). 


Note: When using a Japanese environment, use ¥ instead of \. 
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Coding example: 


-MACRO PLUS1 


ADD #1,R\&V1 ; Preprocessor variable V1 is referenced. 
| .SDATA "\&V'1" ; Preprocessor variable V is referenced. 
. ENDM 
V .ASSIGNC "R" ; Preprocessor variable V is defined. 
| V1 .ASSIGNA 1 ; Preprocessor variable V1 is defined. 
PLUS1 ; PLUS1 is expanded. 


| Expanded results are as follows: 


ADD #1,R1 ; Preprocessor variable V1 is referenced. 
.SDATA "RI" ; Preprocessor variable V is referenced. 


3. Macro generation number 


The macro generation number facility is used to avoid the problem that symbols used within 
a macro body will be multiply defined if the macro is expanded multiple times. To avoid this 
problem, specify the macro generation number marker as part of any symbol used in a 
macro. This will result in symbols that are unique to each macro call. 


The macro generation number marker is expanded as a 5-digit decimal number (between 
00000 and 99999) unique to the macro expansion. 


The syntax for specifying the macro generation number marker is as follows: 
\@ * 
Note: When using a Japanese environment, use ¥ instead of \. 


Two or more macro generation number markers can be written in a macro body, and they 
will be expanded to the same number in one macro call. 


CAUTION! 


Because macro generation number markers are expanded to numbers, they must not be 
written at the beginning of symbol names. 


Reference: Programmer's Guide, 1.3.2, "Coding of Symbols" 
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Coding example: 


- MACRO 
MOV .L 
BRA 
NOP 

- SDATA 

- ALIGN 


str\@ 


end str\@ 
. ENDM 


MOV.L 
BRA 
NOP 
- SDATA 
- ALIGN 


str00000 


end_str00000 
MOV ..L 
BRA 
NOP 

. SDATA 
- ALIGN 


strooool 


end_stro0o0o0o1 


RES STR 
RES STR 


RES STR STR, Rn 
#str\@,\Rn 
end_str\@ 


" \STR" 


2 


"ONE", RO 
"DWO" ; RAL 


Expanded results are as follows: 


#Str00000,RO0O 
end_str00000 


" ONE " 
2 


#str00001,R1 
end_str0d0001 


" TWO W 
2 


| Different symbols are generated each time 
RES_STR is expanded. 


4. Macro replacement processing exclusion 


When a backslash (\) appears in a macro body, it specifies macro replacement processing. 
Therefore, a means for excluding this macro processing is required when it is necessary to 
use the backslash as an ASCII character. 


The syntax for macro replacement processing exclusion is as follows: 


\(<macro replacement processing excluded character string>) 


* 


Note: When using a Japanese environment, use ¥ instead of \. 


The backslash and the parentheses will be removed in macro processing. 
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Coding example: 


-MACRO BACK SLASH SET 


\ (MOV #"\",RO) ; \is expanded as an ASCII character. 
. ENDM 


Expanded results are as follows: 


MOV #"\",RO ; \is expanded as an ASCII character. 


5. Comments in macros 


Comments in macro bodies can be coded as normal comments or as macro internal 
comments. When comments in the macro body are not required in the macro expansion code 


(to avoid repeating the same comment in the listing file), those comments can be coded as 
macro internal comments to suppress their expansion. 


The syntax for macro internal comments is as follows: 


* 


\;<comment > 


Note: When using a Japanese environment, use ¥ instead of \. 


Coding example: 


-MACRO PUSH Rn 


MOV.L \Rn,@-R15 \;  \Rn is a register. 
. ENDM 
PUSH RO 


Expanded results are as follows (the comment is not expanded): 
| MOV .L RO,@-R15 


6. Character string manipulation functions 


Character string manipulation functions can be used in a macro body. The following 
character string manipulation functions are provided. 


SLE sospeteiechemmesseceaces Character string length. 
SENSER., cccssscsvssevevenss Character string search. 
-SUBSTR ..........200000+ Character string extraction. 
References: 


.LEN — Programmer's Guide, 8.5, "Character String Manipulation Functions", .LEN 
INSTR — Programmer's Guide, 8.5, "Character String Manipulation Functions", .INSTR 
.SUBSTR => Programmer's Guide, 8.5, "Character String Manipulation Functions", SUBSTR 
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8.4 Macro Call 


Expanding a defined macro instruction is called a macro call. The syntax for macro calls is as 
follows: 


Syntax 


[<symbol>[:]] <macro name>[ <macro parameter> [,<macro parameter> 


cea] 


Statement Elements 
1. Label 

Enter a reference symbol if required. 
2. Operation 


Enter the macro name to be expanded. The macro name must have been already defined 
before a macro call. 


3. Operands 


Enter character strings as macro parameters to replace formal parameters at macro 
expansion. The formal parameters must have been declared in the macro definition with 
MACRO. 


Description 
1. Macro parameter specification 


Macro parameters can be specified by either positional specification or keyword 
specification. 


— Positional specification 


The macro parameters are specified in the same order as that of the formal parameters 
declared in the macro definition with MACRO. 


— Keyword specification 


Each macro parameter is specified following its corresponding formal parameter, 
separated by an equal sign (=). 
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2. Macro parameter syntax 


Macro parameters must be enclosed with double quotation marks (") or angle brackets (<>) 
if any of the following characters are included in the macro parameters: 


— Space 

— Tab 

— Comma (,) 

— Semicolon (;) 

— Double quotation marks (") 
— Angle brackets (< >) 


Macro parameters are inserted by removing the double quotation marks or angle brackets 
that enclose character strings at macro expansion. 


Coding Example 
JGR SUN FROME0, Ia=9 ; Macro instruction SUM and formal 
IF RFR, FAO ; parameters FROM and TO are defined. 
COUNT .ASSIGMA \FRote1 
-SWHILE jaxtQunl LE 4To 
| IR R\SeguMT ,RLO Macro bodyis coded 
| SOUT ASSIGN ‘RecUT 41 Wing formal param eters. 
| SEMOM 
. EMI 
SUE 0,5 Both will be expanded 
SUE TH=5 | into the sane statements. 


Expanded results are as follows (the formal parameters in the macro body are replaced with 
macro parameters): 


MOV RO,R10 
MOV R1,R10 
MOV R2,R10 
MOV R3,R10 
MOV R4,R10 
MOV R5,R10 
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8.5 Character String Manipulation Functions 


This assembler provides the following character string manipulation functions. 


. LEN Counts the length of a character string. 
| . INSTR Searches for a character string. 
| - SUBSTR Extracts a character string. 
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. LEN 


Character String Length Count 


Syntax 


.LEN[ ] ("<character string>") 


Description 


lL; 


.LEN counts the number of characters in a character string and replaces itself with the 
number of characters in decimal with no radix. 


Character strings are specified by enclosing the desired characters with double quotation 
marks ("). To specify a double quotation mark in a character string, enter two double 
quotation marks in succession. 


Macro formal parameters and preprocessor variables can be specified in the character string 
as shown below. 


.LEN("\<formal parameter>") 
.LEN("\&<preprocessor variable>") * 


Note: When using a Japanese environment, use ¥ instead of \. 


This function can only be used within a macro body (between .MACRO and .ENDM 
directives). 
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.- LEN 


Coding Example: 


~~ 


-MACRO RESERVE LENGTH P1 

-ALIGN 4 

. SRES - LEN ("\P1") 

. ENDM 

RESERVE LENGTH ABCDEF 
RESERVE LENGTH ABC 


Expanded results are as follows: 


.ALIGN 4 

. SRES 6 ; "ABCDEF" has six characters. 

.ALIGN 4 

.SRES 3 ; "ABC" has three characters. | 
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. INSTR | 


Character String Search 


Syntax 
.INSTR[ ] ("<character string 1>","<character string 2>" 
[,<start positions] ) 
Description 
1. .INSTR searches character string | for character string 2, and replaces itself with the 


numerical value of the position of the found string (with 0 indicating the start of the string) 
in decimal with no radix. .INSTR is replaced with —1 if character string 2 does not appear in 
character string 1. 


Character strings are specified by enclosing the desired characters with double quotation 
marks ("). To specify a double quotation mark in a character string, enter two double 
quotation marks in succession. 


The <start position> parameter specifies the search start position as a numerical value, with 
0 indicating the start of character string 1. Zero is used as default when this parameter is 
omitted. 


Macro formal parameters and preprocessor variables can be specified in the character strings 
and as the start position as shown below. 


.INSTR("\<formal parameter>", ...) 
. INSTR ("\&<preprocessor variable>", ...) * 
Note: When using a Japanese environment, use ¥ instead of \. 


This function can only be used within a macro body (between the MACRO and .ENDM 
directives). 
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- INSTR 


Coding Example: 


~~ 


-MACRO FIND STR Pl 

.DATA.W .INSTR("ABCDEFG","\P1",0) 
. ENDM 

FIND STR CDE 

FIND STR H 


Expanded results are as follows: 


.DATA.W 2 ; The start position of "CDE" is 2 (0 indicating the 
beginning of the string) in "ABCDEFG" 
.DATA.W -1 ; "ABCDEFG" includes no "H". 
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- SUBSTR 


-SUBSTR 


Character Substring Extraction 


Syntax 


.SUBSTR[ ] ("<character string>",<start position>,<extraction length>) 


Description 


li 


.SUBSTR extracts from the specified character string a substring starting at the specified 
start position of the specified length. .SUBSTR is replaced with the extracted character 
string enclosed with double quotation marks ("). 


Character strings are specified by enclosing the desired characters in double quotation marks 
("). To specify a double quotation mark in a character string, enter two double quotation 
marks in succession. 


The value of the extraction start position must be 0 or greater. The value of the extraction 
length must be 1 or greater. 


If illegal or inappropriate values are specified for the <start position> or <extraction length> 
parameters, this function is replaced with a space (""). 


Macro formal parameters and preprocessor variables can be specified in the character string, 
and as the start position and extraction length parameters as shown below. 


.SUBSTR("\<formal parameter>", ...) 
. SUBSTR ("\&<preprocessor variable>", ...) * 


Note: When using a Japanese environment, use ¥ instead of \. 


This function can only be used within a macro body (between the .MACRO and .ENDM 
directives). 
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Coding Example: 


-MACRO RESERVE STR P1=0,P2 
.-SDATA .SUBSTR("ABCDEFG",\P1,\P2) 
. ENDM 


~~ 


RESERVE_STR 2,2 
RESERVE STR ,3 ; Macro parameter P1 is omitted. 


Expanded results are as follows: 


-SDATA "CD" 
-SDATA "ABC" 
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- SUBSTR 
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Section 9 Automatic Literal Pool Generation Function 


9.1 Overview of Automatic Literal Pool Generation 


To move 2-byte or 4-byte constant data (referred to below as a "literal") to a register, a literal 
pool (a collection of literals) must be reserved and referred to in PC relative addressing mode. For 
literal pool location, the following must be considered: 


* Is data stored within the range that can be accessed by data move instructions? 

* Is 2-byte data aligned to a 2-byte boundary and is 4-byte data aligned to a 4-byte boundary? 
* Can data be shared by several data move instructions? 

¢ Where in the program should the literal pool be located? 


The assembler automatically generates from a single instruction a .DATA directive and a PC 
relative MOV or MOVA instruction, which moves constant data to a register. 


For example, this function enables program (a) below to be coded as (b): 


(a) 


MOV .L DATA1, RO 
MOV .L DATA2,R1 


-ALIGN 4 
DATA1 -DATA.L H'12345678 
DATA2 -DATA.L 500000 


(b) 


MOV .L #H'12345678,R0 
MOV.L #500000,R1 
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9.2 Extended Instructions Related to Automatic Literal Pool Generation 


The assembler automatically generates a literal pool corresponding to an extended instruction 
(MOV.W #imm, Rn; MOV.L #imm, Rn; or MOVA #imm, RO) and calculates the PC relative 
displacement value. 


An extended instruction source statement is expanded to an executable instruction and literal 
data as shown in table 9-1. 


Table 9-1 Extended Instructions and Expanded Results 


Extended Instruction Expanded Result 

MOV.W_ #imm, Rn MOV.W @(disp, PC), Rn and 2-byte literal data 
MOV.L #imm, Rn MOV.L @(disp, PC), Rn and 4-byte literal data 
MOVA — #imm, RO MOVA @(disp, PC), RO and 4-byte literal data 


9.3 Size Mode for Automatic Literal Pool Generation 


Automatic literal pool generation has two modes: size specification mode and size selection 
mode. In size specification mode, a data move instruction (extended instruction) whose operation 
size is prespecified is used to generate a literal pool. In size selection mode, when a move 
instruction without size specification is written, the assembler automatically checks the imm 
operand value and selects a suitable-size move instruction. 


Table 9-2 shows data move instructions and size mode. 


Table 9-2 Data Move Instructions and Size Mode 


Data Move Instruction Size Specification Mode Size Selection Mode 
MOV #imm, Rn Executable instruction Selected by assembler 
MOV.B #imm, Rn Executable instruction Executable instruction 
MOV.W #imm, Rn Extended instruction ~ Extended instruction 
MOV.L #imm, Rn Extended instruction ~ Extended instruction 


Size Specification Mode: 


In this mode, a data move instruction without size specification (MOV #imm,Rn) is handled as a 
normal executable instruction. This mode is used when -AUTO_LITERAL is not specified as the 
command line option. 


HITACHI 259 


Size Selection Mode: 


In this mode, when a data move instruction without size specification (MOV #imm,Rn) is 
written, the assembler checks the imm operand value and automatically generates a literal pool if 


necessary. The imm value is checked for the signed value range. 


This mode is used when -AUTO_LITERAL is specified as the command line option. 


Table 9-3 shows the instructions selected depending on imm value range. 


Table 9-3 


imm Specification 


Constant or back-reference 
absolute value 


Instructions Selected in Size Selection Mode 


imm Value Range* 


H'FFFFFF80 to H'0000007F 
(-128 to 127) 


Selected Instruction 
MOV.B #imm, Rn 


H'FFFF8000 to H'FFFFFF7F 
(-32,768 to -129) 
H'00000080 to H'00007FFF 
(128 to 32,767) 


MOV.W #imm, Rn 

Expansion result: 

[MOV.W @(disp, PC), Rn and 
2-byte literal data] 


H'80000000 to H'FFFF7FFF 
(-2,147,483,648 to -32,769) 
H'00008000 to H'7FFFFFFF 
(32,768 to 2,147,483,647) 


MOV.L #imm, Rn 
Expansion result: 
[MOV.L @(disp, PC), Rn and 
4-byte literal data] 


Relative value or forward- 
reference absolute value 


Note: The values in parentheses ( 


Reference: 


—AUTO_LITERAL 


Does not depend on imm 
value 


) are decimal. 


MOV.L #imm, Rn 
Expansion result: 
[MOV.L @(disp, PC), Rn and 
4-byte literal data] 


— User's Guide, 2.2.8, "Automatic Literal Pool Generation Command Line Option" 
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9.4 Literal Pool Output 
The literal pool is output to one of the following locations: 


* After an unconditional branch and its delay slot instruction 


* Where a .POOL directive has been specified by the programmer 


The assembler outputs the literal corresponding to an extended instruction to the nearest output 
location following the extended instruction. The assembler gathers the literals to be output as a 
literal pool. 


CAUTION! 


When a label is specified in a delay slot instruction, no literal pool will be output to the location 
following the delay slot. 
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9.4.1 Literal Pool Output after Unconditional Branch 


An example of literal pool output is shown below. 


Source Progra Ih 

fF SECTION CD1, CODE LOCHTE=H'O000FO00 ~ 
| CD1_START: 
MO¥.L  #H' FFFFOOOO , Ro 
MOv.W 4H FFOO, Rl | 
Mov.L #CD1_ START, R2 | 
i | 
! 1 
H I 

| Mor RO, R10 

fercunceual FH i earsipieitvnistem cites gdade atic asad ! 

Pea 

| Automatic literal pool generation resuk [source list] 
ry ooooroog  ciaaalaaes: SECTION CD1,CODE,LOCATE=H'OOo0FOOO 
| 2 ONOOFODO 2 CD1_sTART 
| §=§ ONOOFOOO DoOS 3 MO¥.L 4H FFFFO000 ,Ro 
| 4 OOOOFOO2 9103 4 MOF.W 4H FFOO, Rl 
i §=6§5 QO00FO04 D203 5 Moy.L  #Chl_sTART, he 
| & QOO00FO06 ESFF é Mov HH FF RS 
| =F OOOOFONS OO0E ? RTS 
| 68 OOOOFOOA 6A03 8 Mov ho, R10 
| 
1 
! H 
H ! 
1 
1 1 | 
I ! 
H 1 | 
1 15 9 OM Ce en a aE H | 
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9.4.2 Literal Pool Output to the .POOL Location 


If literal pool output location after unconditional branches is not available within the valid 
displacement range (because the program has a small number of unconditional branches), the 
assembler outputs error 402. In this case, a .POOL directive must be specified within the valid 
displacement range. 


The valid displacement range is as follows: 


* Word-size operation: 0 to 511 bytes 
¢ Longword-size operation: 0 to 1023 bytes 


When a literal pool is output to a .POOL location, a branch instruction is also inserted to jump 
over the literal pool. 


An example of literal pool output is shown on the following page. 
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Bowee program 
| SECTION CD1,CODE,LOCATE=H' OOO0FOO0D 
Ch1_sTART 

MOy.L  #H FFFFOO00, Ro 

Mov. Ww FH FFOO, Rl 


MOv.L {D1 START, R2 


Mov *H FF, RS 
Fieri Sh ec ttc eee 4 
thidtie dd 

Aviomatis leral poolgeneration resuk (sowrve list) 

r 1 OO00FOO 1 SECTION CD1,CODE,LOCATE=H'O000TO00 =| 
| 2 gO00FOOO 2 CD1_START: 
| = 3 OOOOFOOO D003 3 MOv.L 4H FFFFOOOO , Ro 
| 4 0O00FO02 9103 4 MOv.W WH FFOO,R1 
| 5 OO000FO04 D203 5 MOv.L #CD1_START, 22 
| 6 OO0OFOOS ESFF 6 Mov H' FERS 
| F OOOOFOOs ? POOL 
! | 
' ' 
1 
' 1 
! ! 
1 1 
1 1 
1 ! 
1 ! 
! 1 
J 1 
6 & EHD 4 
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9.5 Literal Sharing 


When the literals for several extended instructions are gathered into a literal pool, the assembler 
makes the extended instructions share identical immediate data. 


The following operand forms can be identified and shared: 


¢ Symbol 
* Constant 


¢ Symbol + constant 


In addition to the above, expressions that are determined to have the same value at assembly 
processing may be shared. 


However, extended instructions having different operation sizes do not share literal data even 
when they have the same immediate data. 


An example of literal data sharing among extended instructions is shown on the following page. 
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Bource program 

iia SECTION CD1,CODE,LOCATE=H' OOO0FOOOD | 

| CD1_START: 

| | 

Mov.W 4H FFOO,R1 

: 1 

Moy = #H TE, RS 

RTS 

Mov RO, R10 
| Le eee ee ee H 

t+ bd edd 

Automate literal pool generation resuk [sowee lst] 

ll 1o000ro00=—“—t=“‘“‘“‘é‘;z;])TOCO*t‘(S:S;CCSSEECPTOW CDI,CODE,LOCATE=H' QODOTODD | 
| 2 o000FO00 2 CD1_START: 

| 3 OOO0FOOO DADS 3 Moy.L 4H FFFFOO00 , Ro 
| 4 O000F002 9103 4 Mov. ME FFOO,R1 
| § GOOOFOO4 D202 5 MOv.L  #H' FFFFOOOO ,R2 
| 6 QOO0FOO6 ESEF é Moy? #H' FE RS 
| 7 QOOOFANS O00E ? RTS 
$ QOOOFOOA $A03 8 Mov ho, R10 

| 4 ++#4* BFGIN-POOL **+** 

! 10 oO00FOOC FFOO BATA FOR SOURCE-LINE 4 
11 OOOOFOOE on00 ALIGNMENT CODE 

! 

1 

i 43 +++ FHD-POOL +++#4 
| 14 9 EHD 
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9.6 Literal Pool Output Suppression 


When a program has too many unconditional branches, the following problems may occur: 


* Many small literal pools are output 


¢ Literals are not shared 


In these cases, suppress literal pool output as shown below. 


~ 


<delayed branch instruction> 
<delay slot instruction> 


| . NOPOOL 
Example 
Source program 
Sa i aia” nc aaa mk a al a a a 4 
1 —— ! 
| CASEL 
MOv.L 4H FFFFOOOO,RO = ----- ---- Extended instruction 1 
RTS 
HOP 
a +-- No literal pool is output here 
1 1 
| CASE? 
MOV.L  #H'FFFFOOOO Ro 89 ----- —--- Extended instruction 2 
H RTS 1 
| HOP 
Pea “a= Literal pool is output here 
' i] 
t+etbt de dd 
Automatic literal pool generation resuk (source st) 
ini. eee ee ee ee 71 
i 20 OO0OFOOO 20 CASEL: 
21 go00Fo00 TOO02 21 Movy.L WH FFFFOOOO , Ro 
; 22 OO00FOO2 OO08 oe RTS H 
1 
1 23 O000F004 o00% 23 HOF 
24 24 -HOPOOL 
| 25 OOOOFOOS 25 CASE: ' 
| 26 OOO0FOO8 DOO] 26 Moy.L #H' FFFFOOOO Ro 
| 2? OOOOFOOS OOO; 2 RTS 
| | 26 OO00FO0R oo09 25 HOF 
i 29 ++++ BEGIN-POOL +++# 
1 1 
1 
1 $1 ‘eee THD-POOL ++64 
RE ATs TEETER a a RRA e ee SEN Ue ee eee Re RCA Ce COR eee a ESTER RTO 4 
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9.7. Notes on Automatic Literal Pool Output 


1. Ifan error occurs when an extended instruction is written 


a. Extended instructions must not be specified in delay slots (error 151). 


Extended instructions must not be specified in relative sections having a boundary 
alignment value of less than 2 (error 152). 


c. MOV.L #imm, Rn or MOVA #imm, RO must not be specified in relative sections having 
a boundary alignment value of less than 4 (error 152). 


2. Ifanerror occurs when a .POOL directive is written 
.POOL directives must not be written after unconditional branches (error 522). 
3. Ifan error occurs when a .NOPOOL directive is written 


-NOPOOL directives are valid only when written after delay slot instructions. If written at 
other locations, the LNOPOOL directive causes error 521. 


4. Ifthe displacement of an executable instruction exceeds the valid range when an extended 
instruction is expanded 


The assembler generates a literal pool and outputs error 402 for the instruction having a 
displacement outside the valid range. 


Solution: Move the literal pool output location (for example, by the .NOPOOL directive), or 
change the location or addressing mode of the instruction causing the error. 


5. Ifthe literal pool output location cannot be found 


If the assembler cannot find a literal pool output location satisfying the following conditions 
in respect to the extended instruction, 


— Same file 
— Same section 


— Forward direction 


the assembler outputs, at the end of the section which includes the extended instruction, the 
literal pool and a BRA instruction with a NOP instruction in the delay slot to jump around 
the literal pool, and outputs warning 876. 
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If the displacement from the extended instruction exceeds the valid range 


If the displacement of the literal pool from the extended instruction exceeds the valid range, 
error 402 is generated. 


Solution: Output the literal pool within the valid range (for example, using the .POOL 
directive.) 


Differences between size specification mode and size selection mode 


Version 2.0 of the assembler can only use the size specification mode, but the size selection 
mode is added to this new assembler version. If the source program created before for 
version 2.0 is assembled in the size selection mode by version 3.1 or higher, the imm values 
of data move instructions without size specifications will differ by H'00000080 to 
H'000000FF (128 to 255) from these assembled by version 2.0. 


An example of source listing output in the size specification mode and size selection mode is 
shown on the following page. 
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Exampe : 


Bource program 


Mov. 
Mov. 


1 oonoFo00 
2 O000FO00 
3 O000FO02 
4 0000F004 


6 O000FO0s 
? OOOOFOOR 
5 


9 O000FO0C 
10 OO00FOOE 


1 ooooroo0 
2 o000FO00 
3 o000F002 
4 o000Fo04 


fe 

1 

1 

1 

1 

1 

1 

1 

1 

1 

H 

! 6 OOOO0FOOs 
| 7 OOOOFOOA 
1 8 
1 

1 

1 

1 

1 

1 

i] 

1 

! 

1 

1 

; 


10 OOOOFOOE 
11 oo00rO10 


aH FE RO 
#H' FF,R1 
aH FF RD 


oo00 


oo00 


The eonknts of RGis H'OOOOOOFP. 


SECTION CD1,CODE , LOCATE=H' 0000FO00 


SECTION CD1, CODE, LOCATE=H' oo00ro00 


MOv.L 4H FF, RO 
MOV.W 0 SH EF RI 
MOV.E 4H FF, R2 
RTS 

Moy BO, R10 


#¢¢¢% BEGIN-POOL **4%4 
DATA FOR SOURCE-LIHE 3 
ALIGHMENT CODE 

DATA FOR SOURCE-LIWE 2 
$e6e% FHD-POOL #eee% 


The content: of R3is H'PPFFFFFFP. 
Awomate litral pooloutput insize #lechon mode [source Lstinz] 


SECTION CD1, CODE, LOCATE=H' oooorooo 


MOv.L 4H FF RO 
MOv.W ME FF RI 
MOV.B 4H FF, 2 
RTS 

Mov RO, R1O 


*¢¢¢% BEGIH-POOL **#*# 


ALIGHMEHT CODE 
DATA FOR SOURCE-LIWE 2 
#+#+4+ FHD-POOL *++#4# 
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Section 10 Automatic Repeat Loop Generation Function 


10.1. Overview of Automatic Repeat Loop Generation Function 


In the SH-DSP, the start and end addresses of the repeat loop are set in the RS and RE registers 
by the LDRS and LDRE instructions. The address settings differ depending on the number of 
instructions in the repeat loop. When setting the address, consider the relationship between the 
address and the number of instructions in the repeat loop shown in table 10-1. 


Table 10-1 Repeat Loop Instructions and Address Setting 


Two Three Four or more 
Register Name One Instruction Instructions Instructions Instructions 
RS s_addr0+8 s_addr0+6 s_addr0+4 s_addr 
RE s_addr0+4 s_addr0+4 s_addr0+4 e_addr3+4 


s_addrO: Address of the instruction one instruction before the repeat loop start address 
s_addr: Repeat loop start address 
e_addr3: Address of the instruction three instructions before the repeat loop end address 


The automatic repeat loop generation function automatically generates the PC relative 
instructions LDRS and LDRE, and the SETRC instruction from a single instruction. The LDRS 
and LDRE instructions transfer the repeat loop start and end addresses based on the number of 
instructions in the repeat loop to the RS and RE registers, and the SETRC instruction specifies 
the repetition count. 


For example, program A can be written as program B when using the automatic repeat loop 
generation function. 


Program A: 


LDRS s_addr0+6 
LDRE s_addr0+4 
SETRC #10 
s_addrO: NOP 
PADD AO,MO,AO ; _ Repeat loop start address 
PCMP X1,MO ; Repeat loop end address 
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Program B: 


REPEAT s_addr,e addr,#10 


NOP 
s_addr: PADD AO,MO,AO ;_ Repeat loop start address 
e addr: PCMP X1,M0 ; Repeat loop end address 


10.2. Extended Instructions of Automatic Repeat Loop Generation 
Function 


The assembler automatically generates necessary instructions from extended instructions 
(REPEAT s_label,e_label,#imm, REPEAT s_label,e_label,Rn, and REPEAT s_label,e_label) and 
calculates the PC relative displacement. 


Table 10-2 lists the source statement of each extended instruction and its expanded results of two 
or three executable instructions. 


Table 10-2 Extended Instructions and Expanded Results 


Extended Instruction Expanded Results 

REPEAT s_label,e_label,#imm LDRS @(disp,PC), LDRE@(disp,PC), and 
SETRC #imm 

REPEAT s_label,e_label,Rn LDRS @(disp,PC), LDRE@(disp,PC), and 
SETRC Rn 

REPEAT s_label,e_label LDRS @(disp,PC) and LDRE@(disp,PC) 


10.3. REPEAT Description 
Syntax 
[<symbol>[:]] REPEAT <start address>,<end address>[,<repeat count>] 
Statement Elements 
1. Start and end addresses 
Enter the labels of the start and end addresses of the repeat loop. 
2. Repeat count 


Enter the repeat count as an immediate value or as a general register name. 
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Description 


1. REPEAT automatically generates the executable instructions LDRS and LDRE to repeat the 
instructions in the range from the start address to the end address. 


2. When the repeat count is specified, REPEAT generates a SETRC instruction. When the 
repeat count is omitted, SETRC is not generated. 
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10.4 Coding Examples 
To Repeat Four or More Instructions (Basic Example): 


REPEAT RptStart,RptEnd, #5 
PCLR YO 
PCLR AO 

RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 
PADD AO,Y0,YO PMULS X1,Y1,A0 

DCT PCLR AO 

AND RO,R4 

RptEnd: AND RO,R6 


This program repeats execution of five instructions from RptStart to RptEnd five times. 
The above program has the same meaning as the following: 


LDRS RptStart 
LDRE RptEnd3+4 
SETRC #5 
PCLR YO 
PCLR AO 
RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 


RptEnd3: PADD AO,Y0,YO PMULS X1,¥Y1,A0; The label is not actually generated. 
DCT PCLR AO 
AND RO,R4 
RptEnd: AND RO,R6 
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To Repeat One Instruction: Specify the same labels as the start and end addresses. 


REPEAT Rpt,Rpt,R0 
MOVX @R4+,X1 MOVY @R6,Y1 
Rpt: PADD AO,Y0,YO PMULS X1,Y1,A0 MOVX @R4+,X1 MOVY @R6+,Y1 


The above program has the same meaning as the following: 


LDRS RptStart0+8 
LDRE RptStart0+4 
SETRC RO 


RptStart0: MOVX @R4+,X1 MOVY @R6,Y1___ ; The label is not actually generated 
Rpt : PADD AO,Y0,YO PMULS X1,Y1,A0 MOVX @R4+,X1 MOVY @R6+,Y1 


To Repeat Two Instructions: 


REPEAT RptStart,RptEnd, #10 
PCLR YO 
RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 
RptEnd: PADD AO,Y0O,YO PMULS X1,Y1,A0 


The above program has the same meaning as the following: 


LDRS RptStart0+6 

LDRE RptStart0+4 

SETRC #10 
RptStart0O: PCLR YO ;The label is not actually generated. 
RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 
RptEnd: PADD AO,Y0,YO PMULS X1,Y1,A0 
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To Repeat Three Instructions: 


REPEAT RptStart,RptEnd, RO 
PCLR YO 

RptStart:  MOVX @R4+,X1 MOVY @R6+,Y1 
PMULS X1,Y1,A0 

RptEnd: PADD AO,Y0,YO 


The above program has the same meaning as the following: 


LDRE RptStart0+4 

LDRS RptStart0+4 

SETRC RO 
RptStart0O: PCLR yo ; The label is not actually generated. 
RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 

PMULS X1,Y1,A0 
RptEnd: PADD AO,Y0,YO 


To Omit the Repeat Count: When the repeat count is omitted, the assembler does not generate 
SETRC. To separate the LDRS and LDRE from the SETRC, omit the repeat count. 


REPEAT RptStart,RptEnd 
; The LDRS and LDRE are expanded here. 
MOV #10,R0 
OuterLoop: 
SETRC #16 
PCLR YO 
PCLR AO 
RptStart: MOVX @R4+,X1 MOVY @R6+,Y1 
PADD AO,Y0,YO PMULS X1,Y1,A0 
DCT PCLR AO 
AND RO,R4 


RptEnd: AND RO,R6 
DT RO 
BF OuterLoop 
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10.5 Notes on the REPEAT Extended Instruction 


Start and End Addresses: Only labels in the same section or local labels in the same local 
block can be specified as the start and end addresses. 


The start address must come after (be at a higher address than) the REPEAT extended 
instruction. The end address must come after (be at a higher address than) the start address. 


Reference: Local labels 
— Programmer's Guide, 1.8, "Local Label" 


Instructions Inside Loops: 


* If one of the following assembler directives that reserve a data item or a data area or an .ORG 
directive is used inside a loop, the assembler outputs a warning message and counts the 
directive as one of the instructions to be repeated. If an .ALIGN directive is used inside a loop 
to adjust the boundary alignment, the assembler outputs a warning message and counts the 
directive as one of the instructions to be repeated. 


Directives generating a warning inside loops: 
.DATA, .DATAB, .SDATA, .SDATAB, .SSDATAC, .SDATAZ, .FDATA, .FDATAB, 
.XDATA, .RES, .SRES, .SRESC, .SRESZ, .FRES, .ALIGN, and .ORG 


* The assembler stops automatic generation of literal pools within a loop. Therefore, even when 
an unconditional branch is used in a loop, no literal pool is generated. If a .POOL directive is 
used in a loop, the assembler outputs a warning message and ignores the .POOL directive. 


Instruction Immediately before Loop: If three or fewer instructions are to be repeated, the 
instruction immediately before the loop must be an executable instruction or a DSP instruction. 
Therefore, when three or fewer instructions are to be repeated and if one of the following is 
located immediately before the start address of the loop, the assembler outputs an error. 


¢ Assembler directives that reserve a data item or a data area or .ORG directive 


DATA, .DATAB, .SDATA, .SDATAB, .SDATAC, .SDATAZ, .FDATA, .FDATAB, 
.XDATA, .RES, .SRES, .SRESC, .SRESZ, .FRES, or .ORG 


¢ Literal pool generated by the automatic literal pool output function 


If an unconditional branch instruction and a delay slot instruction are located immediately 
before a loop, or if a .POOL directive is located immediately before a loop, a literal pool may 
be automatically generated. To prevent literal pool generation before a loop, use a .NOPOOL 
directive immediately after the delay slot instruction. 
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* One alignment byte generated by an .ALIGN directive 


When an .ALIGN directive is used immediately after an odd address before a loop, one 
alignment byte may be generated (for example, ALIGN 4 is specified when the location 
counter value is 3). In this case, the contents of the byte before a loop is not an executable 
instruction, and an error message is output. If two or more alignment bytes are generated 
before a loop, their contents consist of a NOP instruction and the program can be correctly 
executed. 


Others: 


* One or more executable or DSP instructions must be located between a REPEAT extended 
instruction and the start address. Otherwise, the assembler outputs an error message. 


¢ A REPEAT extended instruction must not be located between another REPEAT extended 
instruction and its end address. If REPEAT extended instructions are nested, the assembler 
outputs an error message; the first REPEAT is valid, and the other REPEAT instructions are 
ignored. 
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User's Guide 


Section 1 Executing the Assembler 


1.1 Command Line Format 


To start the assembler, enter a command line with the following format when the host computer 
operating system is in the input wait state. 


> aaah & <cinget xcurce £ile> [,<campuk acurce Eile...) [ [4] <conmerd lire oetian> ...] 
| a P| alae ee Le 
td) ea) a 


(1) Assembler start command. 
(2) Name of input source file. Multiple source files can be specified at the same time. 


(3) Command line options, which specify the assembly method in more detail. 
CAUTION! 


When multiple source files are specified on the command line, the unit of assembly processing 
will be the concatenation of the specified files in the specified order. 


In this case, the .END directive must appear only in the last file. 
Supplement: 


The assembler returns the operating system a return code that reports whether or not the 
assembly processing terminated normally. The return value indicates the level of the errors 
occurred as follows. 


Normal termination ..............cccccceeeeeeceeeeseeeseeeeeeees 0 

WearilieS OCCURTEG ........cccccecccassexeanssase ceewetecnaattecees 0 

Errors OCCUITEG .............c0ccccceeeeeeeeeeees Windows"95 and Windows®NT: 2 
UNIX: 1 

Fatal Error OCCUEPED ..:c.sccevescisconeeees cee Windows"95 and Windows*NT: 4 
UNIX: 1 


The return code can be changed with -ABORT. 
Reference: 


—ABORT 
— User's Guide, 2.2.6, "Assembler Execution Command Line Options," -ABORT 
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1.2 File Specification Format 
Files handled by the assembler are specified in the following format. 
<file name>. [<file format>] 


The term "file name" as used in this manual normally refers to both the file name and the file 
format. 


Example: 
(File name) 
FHLEWSEO gasua A file with the file name "file" and the file format "src". 
pProg.Oby «css A file with the file name "prog" and the file format "obj". 


The file format is used as an identifier to distinguish the contents of the file. Thus two files with 
differing formats are different files even if the file name is the same. 


Example: 


file.sre 


file.obj } These file names specify different files. 


The assembler handles the following types of file. 


¢ Source file 


This is a source program file. If a source program file is specified without the file format, the 
file format "src" will be supplied. 


* Object file 
This is an output destination file for object modules. If an object file is specified without the 
file format, the file format obj will be supplied. If an object file is not specified to the 
assembler, a file with the same name as the source file (the first file) and with the file format 
"obj" will be used. 


* Listing file 
This is an output destination file for assemble listings. If a listing file is specified without the 
file format, the extension "lis" will be supplied. If a listing file is not specified to the 
assembler, a file with the same name as the source file (the first file) and with the file format 
"lis" will be used. 
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1.3 SHCPU Environment Variable 


The assembler assembles the program for the CPU specified by the SHCPU environment 
variable. The following shows how to specify the environment variable. 


For UNIX: 
* C Shell 

setenv SHCPU <target CPU> 
* Bourne/Korn Shell 


SHCPU=<target CPU> 
export SHCPU 


For Windows*95 and Windows’ NT: 
SET SHCPU=<target CPU> 
The target CPU can be selected from SH1, SH2, SH2E, SH3, SH3E, SH4, SHDSP, and SH3DSP. 


The priority of target CPU specification is in the order of -CPU, .CPU directive, and SHCPU 
environment variable. 


Note: Be sure to specify this environment variable in uppercase letters. 
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Section 2 Command Line Options 


2.1 Overview of Command Line Options 


Command line options are detailed specifications of the assembly processing. Table 2-1 shows an 
overview of the command line options. 


Table 2-1 Command Line Options 

Section 

Number Command Line Option Function 

2.2.1 Target CPU specifications 
—CPU Specifies target CPU 

2.2.2 Object module specifications 
—[NOJOBJECT Controls output of object module 
—_[NO]DEBUG Controls output of debugging information 
—ENDIAN Selects big endian or little endian 

2.2.3 Assembly listing specifications 
—[NO]LIST Controls output of assembly listing 
—[NO]SOURCE Controls output of source program listing 
-[NO]JCROSS_REFERENCE ~ Controls output of cross-reference listing 
—[NO]SECTION Controls output of section information listing 
—[NO]SHOW Controls output of part of source program listing 
—-LINES Specifies the number of lines in assemble listing 
—COLUMNS Specifies the number of columns in assemble listing 

2.2.4 File inclusion function specifications 
—INCLUDE Specifies the include file directory 

2.2.0 Conditional assembly specifications 
—ASSIGNA Defines integer preprocessor variable 
—ASSIGNC Defines character preprocessor variable 
—DEFINE Defines replacement character string 

2.2.6 Assembler execution specifications 


EXPAND. Outputs preprocessor expansion result 


—ABORT Changes the error level at which the assembler is 
abnormally terminated 
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Table 2-1 Command Line Options (cont) 


Section 
Number Command Line Option Function 
PE Japanese character description specifications 
-SJIS Interprets Japanese characters in source file as shift 
JIS code 
—EUC Interprets Japanese characters in source file as EUC 
code 
—OUTCODE Specifies the Japanese code for output to object 
code 
2.2.8 Automatic literal pool generation specifications 
—AUTO_LITERAL Specifies size mode for automatic literal pool 
generation 
2.2.9 Command line specifications 
—SUBCOMMAND Inputs command line from a file 
2.2.10 Floating-point data specifications 
—ROUND Specifies the rounding mode for floating-point data 
—DENORMALIZE Specifies how to handle denormalized numbers in 
floating-point data 
Supplement: 


The assemble listing is a listing to which the results of the assembly processing are output, and 
consists of a source program listing, a cross-reference listing, and a section information listing. 


References: See appendix C, "Assemble Listing Example", for a detailed description of the 
assemble listing. 
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2.2 Command Line Option Reference 


2.2.1. Target CPU Command Line Option 


This assembler provides the following command line option concerned with the target CPU. 


-CPU 


This command line option specifies the target CPU. 
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-CPU 


Target CPU Specification 


Syntax 


-CPU=<target CPU> 


Description 
1. The —CPU option specifies the target CPU for the source program to be assembled. 
2. The following CPUs can be specified. 


* SH1 (for SH-1) 

* SH2 (for SH-2) 

* SH2E (for SH-2E) 

* SH3 (for SH-3) 

¢ SH3E (for SH-3E) 

* SH4 (for SH-4) 

* SHDSP (for SH-DSP) 

* SH3DSP (for SH3-DSP) 


Relationship with Assembler Directives 


Command Line SHCPU Environment 
Option Assembler Directive Variable Result 
—CPU (regardless of any (regardless of any Target CPU specified by 
specification) specification) —CPU 
(no specification) |.CPU <target CPU> (regardless of any Target CPU specified by 
specification) .CPU 
(no specification) SHCPU = <target CPU> Target CPU specified by 
SHCPU environment 
variable 
(no specification) SH1 


References: Target CPU 
— Programmer's Guide, 5.2.1, "Target CPU Assembler Directive," .CPU 


SHCPU environment variable 
— User's Guide, 1.3, "SHCPU Environment Variable" 
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2.2.2. Object Module Command Line Options 


This assembler provides the following command line options concerned with object modules. 


-OBJECT 


-NOOBJECT 


These command line options control output of an object module. 


-DEBUG 


-NODEBUG 


These command line options control output of debug information. 


-ENDIAN 


This command line option selects big endian or little endian. 
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-OBJECT -NOOBJECT | 


Object Module Output Control 


Syntax 


-OBJECT [= <object output file>] 
| -NOOBJECT 
| The abbreviated forms are indicated by bold face. 


Description 
1. The-—OBJECT option specifies output of an object module. 
The -NOOBJECT option specifies no output of an object module. 


2. The object output file specifies the output destination for the object module. 


1S) 


When the object output file parameter is omitted, the assembler takes the following actions: 


— Ifthe file format is omitted: 
The file format "obj" is supplied. 


— Ifthe specification is completely omitted: 


The file format "obj" is appended to the name of the input source file (the first specified 
source file). 


CAUTION! 


Do not specify the same file for the input source file and the output object file. If the same file is 
specified, the contents of the input source file will be lost. 
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-OBJECT -NOOBJECT | 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 

—OBJECT (regardless of any specification) | An object module is output. 

—NOOBJECT (regardless of any specification) | An object module is not output. 

(no specification) .OUTPUT OBJ An object module is output. 
OUTPUT NOOBJ An object module is not output. 
(no specification) An object module is output. 
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-DEBUG -NODEBUG 


Debug Information Output Control 


Syntax 


-DEBUG 
-NODEBUG 


The abbreviated forms are indicated by bold face. 


Description 
1. The—DEBUG option specifies output of debug information. 
The -NODEBUG option specifies no output of debug information. 


2. The -DEBUG and -NODEBUG options are only valid in cases where an object module is 
being output. 


3. To output debug information, the assembler automatically generates a directory with the 
name "dwfinf" under the directory to which the object file is output, and outputs a 
supplement debugging information (ELF/DWARF supplement information) file whose file 
name is the same as the object file and whose file format is "dwi". 


References: Object module output 
— Programmer's Guide, 5.2.6, "Object Module Assembler Directives", 
OUTPUT 
— User's Guide, 2.2.2, "Object Module Command Line Options", 
—OBJECT —NOOBJECT 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 

—DEBUG (regardless of any specification) | Debug information is output. 

—NODEBUG (regardless of any specification) | Debug information is not output. 

(no specification) .OUTPUT DBG Debug information is output. 
.OUTPUT NODBG Debug information is not output. 
(no specification) Debug information is not output. 
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Supplement: 


-DEBUG 


-NODEBUG 


Debug information is required when debugging a program using the debugger or the emulator, 
and is part of the object module. Debug information includes information about source statement 


lines and information about symbols. 
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-ENDIAN 


Big Endian or Little Endian Selection 


Syntax 


-ENDIAN [=<endian>] 


Endian: {BIG|LITTLE} 


The abbreviated form is indicated by bold face. 


Description 

1. The —ENDIAN option selects big endian or little endian for the target CPU. 
2. The default is big endian. 

Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 

—ENDIAN=BIG (regardless of any specification) | Assembles in big endian 

—ENDIAN=LITTLE (regardless of any specification) | Assembles in little endian 

(no specification) -ENDIAN BIG Assembles in big endian 
-ENDIAN LITTLE Assembles in little endian 
(no specification) Assembles in big endian 


Reference: .ENDIAN 
— Programmer's Guide, 5.2.6, "Object Module Assembler Directives," .ENDIAN 
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2.2.3. Assembly Listing Command Line Options 


listing. 


This assembler provides the following command line options concerned with the assemble 


-LIST 


-NOLIST 


These command line options control output of an assemble listing. 


-SOURCE 


-NOSOURCE 


These command line options control output of a source program listing. 


-CROSS REFERENCE 


-NOCROSS REFERENCE 


These command line options control output of a cross-reference listing. 


-SECTION 


-NOSECTION 


These command line options control output of a section information listing. 


—-SHOW 


-NOSHOW 


These command line options control output of the source program listing. 


-LINES 


-COLUMNS 


This command line option sets the number of lines in the assemble listing. 


This command line option sets the number of columns in the assemble listing. 
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-LIST -NOLIST | 


Assemble Listing Output Control 


Syntax 


| -LIST [ =<listing output file> ] 
-NOLIST | 


| The abbreviated forms are indicated by bold face. 


Description 
1. The—LIST option specifies output of an assemble listing. 
The —NOLIST option specifies no output of an assemble listing. 
2. The listing output file specifies the output destination file for the assemble listing. 
3. When the listing output file parameter is omitted, the assembler takes the following actions: 


— Ifthe file format is omitted: 


The file format "lis" is supplied. 


— Ifthe specification is completely omitted: 


The file format "lis" is appended to the name of the input source file (the first specified 
source file). 


CAUTION! 


Do not specify the same file for the input source file and the output object file. If the same file is 
specified, the contents of the input source file will be lost. 
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-LIST -NOLIST 
Relationship with Assembler Directives 
The assembler gives priority to specifications made with command line options. 
Command Line Option Assembler Directive Result 
—LIST (regardless of any specification) | An assemble listing is output. 
—NOLIST (regardless of any specification) | An assemble listing is not output. 
(no specification) .PRINT LIST An assemble listing is output. 
.PRINT NOLIST An assemble listing is not output. 
(no specification) An assemble listing is not output. 
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-SOURCE -NOSOURCE 


Source Program Listing Output Control 


Syntax 


| -SOURCE 
| -NOSOURCE 


The abbreviated forms are indicated by bold face. | 


Description 
1. The-SOURCE option specifies output of a source program listing to the assemble listing. 


The -NOSOURCE option specifies no output of a source program listing to the assemble 
listing. 


2. The -SOURCE and -NOSOURCE options are only valid in cases where an assemble listing 
is being output. 


References: Assemble listing output 
— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 
PRINT 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST —NOLIST 
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-SOURCE -NOSOURCE 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Result (When an Assemble 


Command Line Option Assembler Directive Listing Is Output) 
—SOURCE (regardless of any specification) | A source program listing is 
output. 
—NOSOURCE (regardless of any specification) | A source program listing is not 
output. 
(no specification) .PRINT SRC A source program listing is 
output. 
.PRINT NOSRC A source program listing is not 
output. 
(no specification) A source program listing is 
output. 
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-CROSS REFERENCE | -NOCROS S REFERENCE 


Cross-Reference Listing Output Control 


Syntax 


-CROSS REFERENCE 
| -NOCROSS REFERENCE 


The abbreviated forms are indicated by bold face. 


Description 


1. The -CROSS_REFERENCE option specifies output of a cross-reference listing to the 
assemble listing. 


The -NOCROSS_REFERENCE option specifies no output of a cross-reference listing to the 
assemble listing. 


2. The -CROSS_REFERENCE and -NOCROSS_REFERENCE options are only valid in cases 
where an assemble listing is being output. 


References: Assemble listing output 
— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 
PRINT 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST —NOLIST 
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-CROSS REFERENCE -NOCROSS REFERENCE 


Relationship with Assembler Directives 
The assembler gives priority to specifications made with command line options. 


Result (When an Assemble 


Command Line Option Assembler Directive Listing Is Output) 
—CROSS_REFERENCE (regardless of any specification) A cross-reference listing is 
output. 
—NOCROSS_REFERENCE (regardless of any specification) A cross-reference listing is not 
output. 
(no specification) PRINT CREF A cross-reference listing is 
output. 
.PRINT NOCREF A cross-reference listing is not 
output. 
(no specification) A cross-reference listing is 
output. 
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-SECTION -NOSECTION 


Section Information Listing Output Control 


Syntax 


-SECTION 
| -NOSECTION 


| The abbreviated forms are indicated by bold face. 


Description 


1. The—SECTION option specifies output of a section information listing to the assemble 
listing. 


The -NOSECTION option specifies no output of a section information listing to the 
assemble listing. 


2. The -SECTION and —NOSECTION options are only valid in cases where an assemble 
listing is being output. 


References: Assemble listing output 
— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 
.PRINT 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST -NOLIST 
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-SECTION -NOSECTION 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive 


Result (When an Assemble 
Listing Is Output) 


—SECTION (regardless of any specification) | A section information listing is 
output. 
—NOSECTION (regardless of any specification) | A section information listing is not 
output. 
(no specification) .PRINT SCT A section information listing is 
output. 
.PRINT NOSCT A section information listing is not 


output. 


(no specification) 


A section information listing is 
output. 
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-SHOW -NOSHOW 


Source Program Listing Output Control 


Syntax 
<UNIX> 
-SHOW [= <output type>[,<output type> ...]] 
-NOSHOW [= <output type>[,<output type> ...]] 


<Windows 95 and Windows NT> 
-SHOW [=(<output type>[,<output type> ...])] 
-NOSHOW [=(<output type>[,<output type> ...])] 


When only one output type is specified, the parentheses can be omitted. 


| Output type: {CONDITIONALS |DEFINITIONS | CALLS |EXPANSIONS | CODE} 


| The abbreviated forms are indicated by bold face. 


Description 


1. The-—SHOW option specifies output of preprocessor function source statements and object 
code lines in the source program listing. 


The -NOSHOW option suppresses output of specified preprocessor function source 
statements and object code display lines in the source program listing. 


2. The items specified by output types will be output or suppressed depending on the option. 
When no output type is specified, all items will be output or suppressed. 


—SHOW: Output 
—NOSHOW: No output (suppress) 
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3. The following output types can be specified: 


-SHOW | -NOSHOW 


Output Type Object Description 
CONDITIONALS Failed condition Condition-failed .AIF or .AIFDEF statements 
DEFINITIONS Definition Macro definition parts, 

-AREPEAT and .AWHILE definition parts, 

.INCLUDE directive statements 

.ASSIGNA and .ASSSIGNC directive statements 
CALLS Call Macro call statements, 

AIF, .AIFDEF, and .AENDI directive statements 
EXPANSIONS Expansion Macro expansion statements 

-AREPEAT and .AWHILE expansion statements 
CODE Object code lines The object code lines exceeding the source 


References: Source program listing output 


statement lines 


— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives”, 


.PRINT 


— User's Guide, 2.2.3, "Assemble Listing Command Line Options”, —LIST 
—NOLIST —SOURCE —NOSOURCE 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 


—SHOW2=<output type> (regardless of any specification) | The object code is output. 


—NOSHOW=<output type> (regardless of any specification) | The object code is not output. 


(no specification) .LIST <output type> (output) The object code is output. 


.LIST <output type> (Suppress) The object code is not output. 


(no specification) 


The object code is output. 
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-LINES 


Setting of the Number of Lines in the Assemble Listing 


Syntax 


-LINES=<line count> 


| The abbreviated form is indicated by bold face. 


Description 


1. The-—LINES option sets the number of lines on a single page of the assemble listing. The 
range of valid values for the line count is from 20 to 255. 


2. The—LINES option is only valid in cases where an assemble listing is being output. 


References: Assemble listing output 
— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 
.PRINT 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST —NOLIST 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 
—LINES=<line count> (regardless of any specification) | The number of lines on a page is 
given by —LINES. 
(no specification) .FORM LIN=<line count> The number of lines on a page is 
given by .FORM. 
(no specification) The number of lines on a page is 
60 lines. 
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-COLUMNS 


Setting of the Number of Columns in the Assemble Listing 


Syntax 


-COLUMNS=<column count> 


The abbreviated form is indicated by bold face. | 


Description 


1. The -COLUMNS option sets the number of columns in a single line of the assemble listing. 
The range of valid values for the column count is from 79 to 255. 


2. The -COLUMNS option is only valid in cases where an assemble listing is being output. 


References: Assemble listing output 
— Programmer's Guide, 5.2.7, "Assemble Listing Assembler Directives", 
PRINT 
— User's Guide, 2.2.3, "Assemble Listing Command Line Options", 
—LIST —NOLIST 


Relationship with Assembler Directives 


The assembler gives priority to specifications made with command line options. 


Command Line Option Assembler Directive Result 
—COLUMNS= (regardless of any specification) | The number of columns in a line 
<column count> is given by -COLUMNS. 
(no specification) .FORM COL=<column count> The number of columns in a line 
is given by .FORM. 
(no specification) The number of columns in a line 


is 132 columns. 
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2.2.4 File Inclusion Function Command Line Option 


This assembler provides the following command line option concerned with the file inclusion 
function. 


-INCLUDE 


This command line option specifies the include file directory. 
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-INCLUDE 


Include File Directory Specification 


Syntax 
-INCLUDE=<directory name>[,<directory name...] | 
The abbreviated form is indicated by bold face. | 
Description 


1. The—-INCLUDE option specifies the include file directory. 
2. The directory name depends on the naming rule of the host machine used. 
3. As many directory name as can be input in one command line can be specified. 


4. The current directory is searched, and then the directories specified by the -INCLUDE are 
searched in the specified order. 


Relationship with Assembler Directives 


Command Line Option Assembler Directive Result 
—INCLUDE (regardless of any specification) (1) Directory specified by 
INCLUDE 
(2) Directory specified by 
—INCLUDE* 
(no specification) .INCLUDE <file name> Directory specified by .INCLUDE 


Note: The directory specified by the -INCLUDE option is added before that specified by 
.INCLUDE. 

Note 

asmsh aaa.mar -include=/usr/tmp,/tmp (UNIX) 

(.INCLUDE "file.h" is specified in aaa.mar.) 

The current directory, /usr/tmp, and /tmp are searched for file.h in that order. 


Reference: INCLUDE 
— Programmer's Guide, 6, "File Inclusion Function" 
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2.2.5 Conditional Assembly Command Line Options 


This assembler provides the following command line options concerned with conditional 
assembly. 


-ASSIGNA 


This command line option defines integer preprocessor variable. 


-ASSIGNC 


This command line option defines character preprocessor variable. 


DEFINE | 


This command line option defines replacement character string. 
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-ASSIGNA 


Integer Preprocessor Variable Definition 


Syntax 


-ASSIGNA=<preprocessor variable>=<integer constant> 
[,<preprocessor variable>=<integer constant>...] 


The abbreviated form is indicated by bold face. 


Description 
1. The—ASSIGNA option sets an integer constant to a preprocessor variable. 
2. The naming rule of preprocessor variables is the same as that of symbols. 


3. An integer constant is specified by combining the radix (B', Q', D', or H') and a value. If the 
radix is omitted, the value is assumed to be decimal. 


4. An integer constant must be within the range from —2,147,483,648 to 4,294,967,295. To 
specify a negative value, use a radix other than decimal. 


Relationship with Assembler Directives 


Command Line Option Assembler Directive Result 

—ASSIGNA ASSIGNA* Value specified by -ASSIGNA 
(no specification) Value specified by -ASSIGNA 

(no specification) ASSIGNA Value specified by ASSIGNA 


Note: When a value is assigned to a preprocessor variable by the -ASSIGNA option, the 
definition of the preprocessor variable by .ASSIGNA is invalidated. 
Note 


When the host machine uses UNIX as the OS, specify a backslash (\) before the apostrophe (') of 
the radix. If a preprocessor variable includes a dollar mark ($), specify a backslash (\) before the 
dollar mark. 


Example: asmsh aaa.mar -assigna= \$=H\'FF (UNIX) 


Value H'FF is assigned to preprocessor variable _$. All references (\&_$) to preprocessor 
variable _$ in the source program are set to H'FF. 


HITACHI 311 


-ASSIGNA 


Reference: .ASSIGNA 
— Programmer's Guide, 7.2, "Conditional Assembly Directive," .ASSIGNA 
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-ASSIGNC 


Character Preprocessor Variable Definition 


Syntax 


-ASSIGNC=<preprocessor variable>="<character string>" 
[,<preprocessor variable>="<character 
strings” ...] 


The abbreviated form is indicated by bold face. 


Description 

1. The —ASSIGNC option sets a character string to a preprocessor variable. 
2. The naming rule of preprocessor variables is the same as that of symbols. 
3. Accharacter string must be enclosed with double-quotation marks ("). 

4. Up to 255 characters (bytes) can be specified for a character string. 
Relationship with Assembler Directives 


Command Line Option Assembler Directive Result 


—ASSIGNC .ASSIGNC directive” Character string specified by -ASSIGNC 
(no specification) Character string specified by -ASSIGNC 
(no specification) .ASSIGNC directive Character string specified by AASSIGNC 


Note: When a character string is assigned to a preprocessor variable by the -ASSIGNC option, 
the definition of the preprocessor variable by .ASSIGNC is invalidated. 


Note 


To specify the following characters in a character string when the host machine uses UNIX as the 
OS, specify a backslash (\) before the characters. To specify character strings before and after the 
following characters, enclose the character strings with double-quotation marks ("). 


¢ Exclamation mark (!) 

* Double-quotation mark (") 
* Dollar mark ($) 

¢ Back quotation mark (°) 
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-ASSIGNC 


asmsh aaa.mar -assignc=_\$="ON"\!"OFF" (UNIX) 


Character string ON!OFF is assigned to preprocessor variable _$. All references (\&_$) to 
preprocessor variable _$ in the source program are set to ON!OFF. 


Reference: .ASSIGNC 
— Programmer's Guide, 7.2, "Conditional Assembly Directive," .ASSIGNC 
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-DEFINE 


Replacement Character String Definition 


Syntax 


-DEFINE=<replacement symbol>="<character string>" 
[,<replacement symbol>="<character 
Strings" s.<]J 


The abbreviated form is indicated by bold face. 


Description 


1. The —DEFINE option defines that the specified symbol is replaced with the corresponding 
character string by the preprocessor. 


2. Differences between -DEFINE and -ASSIGNC are the same as those between .DEFINE and 
.ASSIGNC. 


Relationship with Assembler Directives 


Command Line Option Assembler Directive Result 


—DEFINE .DEFINE directive* Character string specified by -DEFINE 
(no specification) Character string specified by -DEFINE 
(no specification) .DEFINE directive Character string specified by .DEFINE 


Note: When a character string is assigned to a replacement symbol by the -DEFINE option, the 
definition of the replacement symbol by .DEFINE is invalidated. 


Reference: .DEFINE 
— Programmer's Guide, 7.2, "Conditional Assembly Directive," .DEFINE 
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2.2.6 | Assembler Execution Command Line Option 


This assembler provides the following command line options concerned with assembler 
execution. 


-EXPAND 


This command line option outputs preprocessor expansion result. 


-ABORT 


This command line option changes the error level at which the assembler is abnormally 
terminated. 
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—-EXPAND 


Preprocessor Expansion Result Output 


Syntax 


-EXPAND [=<output file name>] 


The abbreviated form is indicated by bold face. 


| 
| 
| 


Description 


1. The EXPAND option outputs an assembler source file for which macro expansion, 
conditional assembly, and file inclusion have been performed. 


2. When this option is specified, no object will be generated. 
3. When the output file parameter is omitted, the assembler takes the following actions: 


— Ifthe file format is omitted: 


The file format "exp" is used. 


— Ifthe specification is completely omitted: 
The file format "exp" is appended to the name of the input source file (the first specified 
source file). 


4. Do not specify the same file name for the input and output files. 
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-ABORT 


Change of Error Level at Which the Assembler Is Abnormally Terminated 


Syntax 


-ABORT=<error level> 


| Error level: {WARNING | ERROR} 


| The abbreviated form is indicated by bold face. 


Description 


1. The—ABORT option specifies the error level and changes the return value to the OS 
depending on the assembly result. 


2. The return value to the OS is as follows: 


Return Value to OS when Option Specified 


Number of Cases ABORT=WARNING ABORT=ERROR* 
Windows°95, Windows"95, 
Warning’ Error Fatal Error Windows°NT UNIX Windows°NT UNIX 
0 0 0 0 0 0 0 
1ormore 0 0 2 1 0 0 
— 1ormore 0 2 4 2 1 
— — 1 or more 4 1 4 1 


Note: The underline indicates the default option setting. 


3. When the return value to the OS becomes | or larger, the object module is not output. 


4. The —ABORT option is valid only when the object module output is specified. 
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2.2.7 Japanese Character Description Command Line Options 


This assembler provides the following command line options concerned with Japanese characters 
description in source files. 


-SJIS 


This command line option interprets Japanese kanji characters in source files as shift JIS 
code. 


-EUC 


This command line option interprets Japanese kanji characters in source files as EUC code. 


-OUTCODE 


This command line option specifies the Japanese kanji code for output to object file. 
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-SJIS 


Interpretation of Japanese Characters as Shift JIS Code 


Syntax 


-SJIS 


Description 


1. The —SJIS option enables Japanese characters to be written in character strings and 


comments. 

STS ies adovwisensignanonsyseceneetei Japanese characters in character strings and comments are 
interpreted as shift JIS code. 

No specification ............ Japanese characters in character strings and comments are 


interpreted as Japanese code specified by the host machine. 
2. Do not specify this option together with the -EUC option. 


Reference: Shift JIS code 
— Programmer's Guide, 1.4.2 "Character Constants" 
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-EUC 


Interpretation of Japanese Characters as EUC Code 


Syntax 


-EUC 


Description 


1. The —EUC option enables Japanese characters to be written in character strings and 


comments. 

BUG, sccscsvsverved ennieces Japanese characters in character strings and comments are 
interpreted EUC code. 

No specification ............ Japanese characters in character strings and comments are 


interpreted as Japanese code specified by the host machine. 
2. Do not specify this option together with the —SJIS option. 


Reference: EUC code 
— Programmer's Guide, 1.4.2 "Character Constants" 
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-OUTCODE 


Specification of Japanese Code for Output to Object File 


Syntax 


-OUTCODE=<Japanese code> 
<Japanese code>: {SJIS|EUC} 


The abbreviated form is indicated by bold face. 


Description 


1. The-OUTCODE option converts Japanese characters in the source file to the specified 
Japanese kanji code for output to the object file. 


2. The Japanese code output to the object file depends on the -OUTCODE specification and the 
code (—SJIS or -EUC) in the source file as follows: 


Japanese Code in Source File 


—OUTCODE 

Specification -SJIS —-EUC No Specification 

SJIS Shift JIS code Shift JIS code Shift JIS code 

EUC EUC code EUC code EUC code 

No specification Shift JIS code EUC code Default code 
Default code is as follows. 

Host Machine Default Code 

SPARC station EUC code 

HP9000/700 series Shift JIS code - 

PC9800 series Shift JIS code 


IBM PC and its compatible machine 


Reference: Japanese code in the source file 
— User's Guide, 2.2.7 "Japanese Character Description Command Line Options" 


—SJIS 


— User's Guide, 2.2.7 "Japanese Character Description Command Line Options" 


—EUC 
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2.2.8 Automatic Literal Pool Generation Command Line Option 


This assembler provides the following command line option concerned with automatic literal 
pool generation. 


-AUTO LITERAL | 


This command line option specifies the size mode for automatic literal pool generation. 
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-AUTO LITERAL 


Size Mode Specification for Automatic Literal Pool Generation 


Syntax 


| 
| -AUTO_ LITERAL 


The abbreviated form is indicated by bold face. 


Description 
1. The—-AUTO_LITERAL option specifies the size mode for automatic literal pool generation. 


— When this command line option is specified, automatic literal pool generation is 
performed in size selection mode, and the assembler checks the imm value in the data 
move instruction without operation size specification (MOV #imm,Rn) and 
automatically generates a literal pool if necessary. 


— When this option is not specified, automatic literal pool generation is performed in size 
specification mode, and the data move instruction without size specification is handled 
as a 1-byte data move instruction. 


2. In the size selection mode, the imm value in the data move instruction without operation size 
specification is handled as a signed value. Therefore, a value within the range from 
H'00000080 to H'000000FF (128 to 255) is regarded as word-size data. 


Selected Size or Error 


Size Selection Size Specification 
imm Value Range* Mode Mode 
H'80000000 to H'FFFF7FFF (—2,147,483,648 to Long word Warning 835 
—32,769) 
H'FFFF8000 to H'FFFFFF7F (—32,768 to —129) Word © Warning 835 
H'FFFFFF80 to H'0000007F (—128 to 127) Byte Byte 
H'00000080 to H'000000FF (128 to 255) Word Byte 
H'00000100 to H'00007FFF (256 to 32,767) Word Warning 835 
H'00008000 to H'7FFFFFFF (32,768 to Long word Warning 835 


2,147,483,647) 
Note: The value in parentheses (_) is in decimal. 
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-AUTO_LITERAL _ 


Reference: Size selection mode 
Size specification mode 
— Programmer's Guide, 9.3 "Size Mode for Automatic Literal Pool Generation" 
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2.2.9 Command Line Input Command Line Option 


This assembler provides the following command line option concerned with command line input. 


-SUBCOMMAND | 


This command line option inputs command line specifications from a file. 
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-SUBCOMMAND 


Command Line Specification Input from File 


Syntax 


-SUBCOMMAND=<subcommand file name> 


The abbreviated form is indicated by bold face. 


Description 

1. The-SUBCOMMAND option inputs command line specifications from a file. 

2. Specify input file names and command line options in the subcommand file in the same 
order as for normal command line specifications. 

3. Only one input file name or one command line option can be specified in one line in the 
subcommand file. 

4. This option must be specified at the end of a command line. The remaining files and options 
are read from the specified subcommand file. 

5. This option must not be specified in a subcommand file. 

Example: 


asmsh aaa.src -subcommand=aaa.sub 


The subcommand file contents are expanded to a command line and assembled. 


! 
! 
bbb. sec 
-list 
1 
1 


The above command line and file aaa.sub are expanded as follows: 


asmsh aaa.src,bbb.srce -list -noobj 
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- SUBCOMMAND 


Notes 
1. One line of a subcommand file can include a maximum of 300 bytes. 


2. One subcommand file can include a maximum of 32,767 bytes. 
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2.2.10 Floating-Point Data Command Line Options 


This assembler provides the following command line options concerned with floating-point data. 


-ROUND | 


This command line option specifies the rounding mode for floating-point data. 


-DENORMALIZE | 


This command line option specifies how to handle denormalized numbers in floating-point 
data. 
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-ROUND 


Specification of Floating-Point Data Rounding Mode 


Syntax 


| -ROUND=<rounding mode> 
<rounding mode>: {NEAREST | ZERO} 
The abbreviated form is indicated by bold face. 


Description 


1. The-ROUND option specifies the rounding mode used when converting constants in 
floating-point data assembler directives into object codes. 


2. The following two rounding modes can be selected. 


— round to NEAREST even (NEAREST) 
— round to ZERO (ZERO) 


3. When the -ROUND option is not specified, the rounding mode depends on the CPU type as 


follows: 
CPU Type Rounding Mode 
SH-1 round to NEAREST even 
SH-2 round to NEAREST even : 
SH-2E round to ZERO 
SH-3 round to NEAREST even 
SH-3E round to ZERO : 
SH-4 round to NEAREST even 
SH-DSP round to NEAREST even : 
SH3-DSP round to NEAREST even 
CAUTION! 


When the CPU type is SH-2E or SH-3E and round to NEAREST even is selected as the rounding 
mode, warning number 818 occurs at the first floating-point data assembler directive in the 
source program, and object code is output in the selected "round to NEAREST even" rounding 
mode. 
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—-ROUND 


Reference: Rounding mode 
— Programmer's Guide, 1.4.3 "Floating-Point Constants" 
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-DENORMALIZE 


Specification of Handling Denormalized Numbers in Floating-Point Data 


Syntax 


| -DENORMALIZE=<selection type> 
| <selection type>:{ON|OFF} 
The abbreviated form is indicated by bold face. 


Description 


1. The—-DENORMALIZE option specifies whether to handle the denormalized numbers in 
floating-point data assembler directives as valid values. 


2. The object code differs when denormalized numbers are specified as valid values (ON) and 
invalid values (OFF). 


— Valid: Warning number 842 occurs and the object code is output. 


— Invalid: Warning number 841 occurs and zero is output for the object code. 


ios) 


When the -DENORMALIZE option is not specified, whether the denormalized numbers are 
valid depends on the CPU type as follows: 


CPU Type Denormalized Numbers 

SH-1 Valid (ON) 

SH-2 Valid (ON) 

SH-2E Invalid (OFF) : - 
SH-3 Valid (ON) 

SH-3E Invalid (OFF) 

SH-4 Valid (ON) 

SH-DSP Valid (ON) 

SH3-DSP Valid (ON) ; 
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| -DENORMALIZE 


CAUTION! 


When the CPU type is SH-2E or SH-3E and denormalized numbers are specified as valid, 
warning number 818 occurs at the first floating-point data assembler directive in the source 
program, and object code is output with the denormalized numbers handled as valid values as 
specified. 


Reference: Denormalized numbers 
— Programmer's Guide, 1.4.3 "Floating-Point Constants" 
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Appendix 


Appendix A Limitations and Notes on Programming 


Table A-1 Limitations and Notes on Programming 


No. Item Limitation 
Character types ASCII characters, shift JIS code, EUC code 
Z Upper/lowercase letter distinctionSymbols (including section names) } Distiqauishad 
Object module names 9 


Reserved words 

Executable instruction mnemonics 

DSP instruction mnemonics Not 
Assembler directive mnemonics distinguished 
Operation sizes 

Integer constant radixes 


3 Line length Up to 255 bytes 
4 Program length (in lines) Up to 65,535 lines ; 
5 Character constants Up to 4 characters 
6 Symbol length Up to 251 characters 
7 Number of symbols Up to 65,535 symbols 
8 Number of import symbols Up to 65,535 symbols - 
9 Number of export symbols Up to 65,535 symbols 
10 Section size Up to H'FFFFFFFF bytes 
aT Number of sections Up to 65,535 sections ; 
12 Number of macro generation Up to 100,000 numbers 
numbers 
13 Number of literals Up to 100,000 literals 
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| Macros and subroutines for addition, subtraction, multiplication, and division of fixed-point 
| data in the following format: 


| Note: Operation results are rounded off. Neither underflow nor overflow is checked. 


| Data Format 


parameters. 


| Subtraction (—): Macro call FIX_SUB [parameter 1], [parameter 2] 


Appendix B Sample Program 
This appendix presents a sample program written for this assembler. 


B.1 Sample Program Specifications 


Functional Specification 


<parameter 1> OP <parameter 2> — result 
OP: +, —%, + | 


Pedster |g | regerpat | Frere 


Sign bit + . 
Dexirnal point 


The location of the decimal point is set in preprocessor variable POINT as the number of bits 
from the MSB. 


Inputs and Outputs 


Inputs: Set parameter | in register Parm1. 
Set parameter 2 in register Parm2. 
For addition and subtraction, parameters 1 and 2 can be specified as macro | 


Output: The result is stored in register Parm1. 


Macro and Subroutine Usage 
Addition (+): Macro call FIX_ADD [parameter 1], [parameter 2] 


Multiplication (x): Subroutine call FIX_MUL 
Division(+): Subroutine call FIX_DIV 


Registers to be Used 


Define the following registers with the .REG directive: 
Parml, Parm2, WORK1, WORK2, WORK3, WORK4 


338 HITACHI 


B.2. Coding Example 


HULO1 


HULO2 


HULOS 


FIT aDD Rs=Farm?, AFarm 


FII G&S ASFarm?,A+Parml 


-HacRo 

ADD \As, iad 
-EWDH 

-Hacko 

Sun \As, Wad 

- E MDH 

DIWS Farml,Farm 
Hovr WORK 
CHE/FZ Parml 

ET HULG1 

WEG Farml, Farm 
CHE/PZ Farm2 

Br HULO2 

WEG Parm2, Farm 
HULU Farml, Farm 
SWAP. Farml, Farm 
ats HACL ,WORK2 
HULU Parml, Farm 
SWAP. = Farml, Farm 
Sar. Parcm2, Farm 
STS HACL WORKS 
HULU Farml, Farm 
Svar. Farmil, Farm 
ats HACL ,WORKA 
HULU Farml, Parne 
cLEr 

ats HaACL ,Farml 
Hoy WORK, Farna 
SHLALG WORKS 
SHIL16 Farm2 

ADOC Parm?2, WORK? 
ADOC WORK?, Farm 
Hoy WORKS, Farne 
SHIR16 WORK 
SHIL16 Farm2 

ABCC WORKS, Farm 
-AREPEAT .LPOINT 
SHIL Parm2 

ROTL Parml 

- AEN DR 

BHIR WORK 

HF HULOS 

WEG Parml, Farm 
RTS 

WOP 


1 
-J 


; Slores ihe sign of fe resulin WORK 1. 


tH (Pam1 <0), Parmi = -Parm1 


IH (Pam2 <0), Parm2 = -Pam2 


Perm 1 ow) * Parme flow) 


Perm 1 (high) * Pam? flow) 


Pam 1 flow) * Parm2 (high) 


Perm 1 (high) * Parm2( high) 


Adds the sign. 


' 
L 


Sms 16D Munplicaton result. 


Corectk dédmal ponilocaton. 


(Continued on following page.) 
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| FIH_DIV: 


thoy #0, WOREI : “7 | 
BIVOS WORKL, Parmi ; diidendise negative value, | 
SUE? WORKL,Parmi 5 _teonverts tp I's complement. 

.SFEPEAT (4PoINt ; 4 

SHER Farmi > [Comects decimal pointlocsion. 

ROIGR  HORKL ; 
SEND ; | 
DIS Fawn, Pasmi i 
.SFEPEST 32 , 3 


ReI=L HOREL 
DIVi Panne , Parmi 


Perm (WORK 'Pam 2 — Yt RE A 


. SEND = 

ReIeL ORK ; | 
rie #0, Farmi ; 7 
S&DOy Parmi, WOoRKi i ' Converts > 2's com plement 

rio HORK1, Parmi poet 

RIs 

HOF 
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Appendix C Assemble Listing Output Example 


The assemble listing shows the result of the assemble processing. The assemble listing consists of 
a source program listing, a cross-reference listing, and a section information listing. 


This appendix describes the content and output format of the assemble listing using the assembly 
of the source program shown below as an example. This uses the sample program shown in 
appendix B to calculate the following: 


15% 2.25435 


POINT 
Parml 
Parm2 
WORK1 
WORK2 
WORK3 
WORK4 


aaa 


start 


.ASSIGNA 16 
.REG (RO) 
. REG (R1) 
.REG (R2) 
.REG (R3) 
.REG (R4) 
.REG (R5) 


- SECTION SAMPLE, CODE, ALIGN=4 
. INCLUDE "appendix B" 


. REG (R8) 

. REG (R9) 

.REG (R10) 

.REG (R11) 

sTSs PR,@-SP 
MOV.L #H'00018000,a 
MOV.L #H'00024000,b 
MOV.L #H'00030000,c 
MOV.L #H'00050000,d 
MOV a, Parml 
MOV b, Parm2 

BSR FIX_MUL 
NOP 
MOV Parml,a 

MOV c, Parml 

MOV d, Parm2 

BSR FIX DIV 

NOP 

FIX_ADD a 

MOV Parml,a 

LDS @SP+,PR 

RTS 

NOP 

. END 
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C.1 Source Program Listing 


The source program listing lists information related to the source statements, including the line 
number and the corresponding object code. 


Figure C-1 shows an example of a source program listing. 


cae Boper™ ROC aqme ASSIMELER Yer. 4.0 ttt OLsi alee date ao 
TROGRAH MAHE = “5 MHELE * 


JIEADING ¢* “SAMRLE’*¢ 
LASEDGMA oF 

rPD 

ri} 

Fe} 

r\ 

Fab} 

4 


QJ&e by ee 
co 


Ti 
Ti 
Tai 
Ti 
Ti 
4 I 

iH th 

RARKA FEC IN-POOL tt ttt 
ERA TO IND-FoOOoOL 
MOF 

IAT. FOR SOURCE-LINE 217 
DAT, FOR SOCRCE-LINE 215 
DAT. FOR SOC E-LINE 21> 
IATA FOR SOURCE-LINE 220 
RRAAA IND -bOOL thet 
. END 


SHES 


= 
zi 
= 
= 
= 


Figure C-1 Source Program Listing Output Example 
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(1) Line numbers (in decimal) 

(2) The value of the location counter (in hexadecimal) 

(3) The object code (in hexadecimal). The size of the reserved area in bytes is listed for areas 
reserved with the .RES, .SRES, .SRESC, .SRESZ, and .FRES assembler directives. 

(4) Source line numbers (in decimal) 

(5) Expansion type. Whether the statement is expanded by file inclusion, conditional assembly 
function, or macro function is listed. 
In: File inclusion (n indicates the nest level). 
C: Satisfied conditional assembly, performed iterated expansion, or satisfied conditional 

iterated expansion 

M: Macro expansion 

(6) The source statements 

(7) The header setup with the HEADING assembler directive. 

(8) The literal pool 

(9) The total number of errors and warnings. Error messages are listed on the line following the 
source statement that caused the error. 
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C.2 Cross-Reference Listing 


The cross-reference listing lists information relating to symbols, including the attribute and the 
value. 


Figure C-2 shows an example of a cross-reference listing. 


chk Deperh RDO enqume ARSIHFLER Yer. 4.0 #244 OAs i SIRS dase ko 


eek Chose REFERENCE LICT 


PEAGNERERE 


Figure C-2 Cross-Reference Listing Output Example 


(1) The symbol name 

(2) The name of the section that includes the symbol (first eight characters) 

(3) The symbol attribute 

Export symbol 

Import symbol 

Section name 

Symbol defined with the .REG assembler directive 
Symbol defined with the .FREG assembler directive 
Symbol defined with the ASSIGN assembler directive 
Symbol defined with the .EQU assembler directive 
Symbol defined two or more times 

Undefined symbol 

No symbol attribute (blank)............ A symbol other than those listed above 


(4) The value of symbol (in hexadecimal) 


(5) The list line numbers (in decimal) of the source statements where the symbol is defined or 
referenced. The line number marked with an asterisk is the line where the symbol is defined. 
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C.3. Section Information Listing 


The section information listing lists information related to the sections in a program, including 
the section type and section size. 


Figure C-3 shows an example of a section information listing. 


kak Dxpertl RESO aoqune ASSIHPLER Yer. 4.0 tt% OLJiasAE deste 40 


24 SECTION ItTA LIT 


Figure C-3 Section Information Listing Output Example 


(1) The section name 

(2) The section type 

Relative address section 
Absolute address section 
Code section 

Data section 

Common section 

Stack section 

Dummy section 


(3) The section size (in hexadecimal, byte units) 
(4) The start address of absolute address sections 
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Appendix D_ Error Messages 


D.1 = Error Types 
(1) Command Errors 


These are errors related to the command line that starts the assembler. These errors can occur, for 
example, in cases where there are errors in the source file or command line option specifications. 


The assembler outputs the error message to standard error output (usually the display).”! The 
format of these messages is as follows: 2 


" ", line <line number>:<error number> (E) <message> 


Example: 


" ", line 0: 10(E) NO INPUT FILE SPECIFIED 


Notes: 1. The assembler outputs the message to standard output when Windows°95 or 
Windows® NT is used. 


2. The format is as follows when Windows"95 or Windows® NT is used: 


| (<line number>): <error number>(E) <message> 


Example: 


(0): 10(E) NO INPUT FILE SPECIFIED 


(2) Source Program Errors 
These are syntax errors in the source program. 


The assembler outputs the error message to standard output (usually the display) or the source 
program listing. (If a source program listing is output during assembly, these messages are not 
output to standard output.)"! 
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The format of these messages is as follows: 2 


"<source file name>",line <line number>: <error number>(E) <message> 


"<source file name>",line <line number>: <error number>(W) <message> | 


Example: 


"PROG. 
"PROG. 


SRC",line 25: 300(E) ILLEGAL MNEMONIC 
SRC", line 33: 811(W) ILLEGAL SYMBOL DEFINITION 


Notes: 1. 


The assembler outputs the message to standard output or the source program listing 
when Windows"95 or Windows® NT is used. 


. The format is as follows when Windows®95 or Windows® NT is used: 


<source file name>(<line number>): <error number>(E) <message> 


<source file name>(<line number>): <error number>(W) <message> 


Example: 


PROG.SRC(25): 300(E) ILLEGAL MNEMONIC 
PROG.SRC(33): 811(W) ILLEGAL SYMBOL DEFINITION 


The source program error numbers are classified as follows: 


100 10 199) ..cccsssessecesve General source program syntax errors 

200 01299 sscccsssenstvessve Errors in symbols 

300 10:349 swccsssveeracsces Errors in operations and/or operands 

350 10399. c2v.catvivesnvs Errors in DSP instructions 

400 to 499 ... ... Errors in expressions 

500 t0'S99 2. ..cncssienes Errors in assembler directives 

600 to 699 .........ceee. Errors in file inclusion, conditional assembly, or macro function 
700 to 799 Warnings in DSP instructions 


800 to 999 


General source program warnings 
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(3) Fatal Errors 


These are errors related to the assembler operating environment, and can occur, for example, if 
the available memory is insufficient. 


The assembler outputs a message to standard error output. ! The format of these messages is as 
follows: "2 


non 


, line <line number>:<error number> (F) <message> 


Example: 


"", line 0: 903(F) LISTING FILE OUTPUT ERROR 


Notes: 1. The assembler outputs the message to standard output when Windows"95 or 
Windows NT is used. 


2. The format is as follows when Windows"95 or Windows® NT is used: 


(<line number>): <error number>(F) <message> 


Example: 


[ 
| Sere 903(F) LISTING FILE OUTPUT ERROR 


Assembly processing is interrupted when a fatal error occurs. 
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D.2 


Error Message Tables 


Table D-1 
10 Message: 
Meaning: 


Recovery procedure: 


Command Error Messages 


NO INPUT FILE SPECIFIED 
There is no input source file specified. 
Specify an input source file. 


20 Message: CANNOT OPEN FILE <file name> 

Meaning: The specified file cannot be opened. 

Recovery procedure: Check and correct the file name and directory. 
30 Message: INVALID COMMAND PARAMETER 

Meaning: The command line options are not correct. 

Recovery procedure: Check and correct the command line options. 
40 Message: CANNOT ALLOCATE MEMORY 

Meaning: All available memory is used up during processing. 

Recovery procedure: This error only occurs when the amount of available user memory is 
extremely small. If there is other processing occurring at the same 
time as assembly, interrupt that processing and restart the 
assembler. If the error still occurs, check and correct the memory 
management employed on the host system. 

50 Message: COMPLETED FILE NAME TOO LONG <file name> 

Meaning: The file name including the directory is too long. 


Recovery procedure: 


Supplement: 


Shorten the total length of the file name and directory path. 


It is possible that the object module output by the assembler after 
this error has occurred will not be usable with the debugger. 
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Table D-2 Source Program Error Messages 


General Source Program Syntax Errors 


100 Message: OPERATION TOO COMPLEX 
Error description: Too complex operation. 
Recovery procedure: Simplify the expression for the operation. 
101. Message: SYNTAX ERROR IN SOURCE STATEMENT 
Error description: Syntax error in source statement. 
Recovery procedure: Check and correct the whole source statement. 
102 Message: SYNTAX ERROR IN DIRECTIVE 
Error description: Syntax error in assembler directive source statement. 
Recovery procedure: Check and correct the whole source statement. 
104 Message: LOCATION COUNTER OVERFLOW 
Error description: The value of location counter exceeded its maximum value. 
Recovery procedure: Reduce the size of the program. 
105 Message: ILLEGAL INSTRUCTION IN STACK SECTION 
Error description: An executable instruction, DSP instruction, extended instruction, or 
assembler directive that reserves data is in the stack section. 
Recovery procedure: Remove, from the stack section, the executable instruction, DSP 
instruction, extended instruction, or assembler directive that 
reserves data. 
106 Message: TOO MANY ERRORS 
Error description: Error display terminated due to too many errors. 
Recovery procedure: Check and correct the whole source statement. 
108 Message: ILLEGAL CONTINUATION LINE 
Error description: Illegal continuation line. 
Recovery procedure: Check and correct continuation line. 
109 Message: LINE NUMBER OVERFLOW 
Error description: The number of lines being assembled exceeded 65,535 lines. 
Recovery procedure: Subdivide the program into multiple files. 
150 Message: INVALID DELAY SLOT INSTRUCTION a 


Error description: 


Recovery procedure: 
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Illegal executable instruction placed following delayed branch 
instruction in memory. 


Change the order of the instructions so that the illegal instruction 
does not immediately follow a delayed branch instruction. 


Table D-2 Source Program Error Messages (cont) 


151 Message: ILLEGAL EXTENDED INSTRUCTION POSITION 
Error description: Extended instruction placed following a delayed branch instruction in 
memory. 
Recovery procedure: Place an executable instruction following the delayed branch 
instruction. 
152 Message: ILLEGAL BOUNDARY ALIGNMENT VALUE 
Error description: lllegal boundary alignment value specified for a section including 
extended instructions. 
Recovery procedure: Specify 2 or a larger multiple of 2 as a boundary alignment value. 
153 Message: ILLEGAL ADDRESS 


Error description: 


Recovery procedure: 


REPEAT Errors 


160 


161 


162 


Message: 
Error description: 


Recovery procedure: 


Message: 
Error description: 


Recovery procedure: 


Message: 
Error description: 


Recovery procedure: 


Supplement: 


Symbol Errors 


Executable or extended instruction placed at an odd address. 
Place executable and extended instructions at even addresses. 


REPEAT LOOP NESTING 

Another REPEAT is located between a REPEAT and its end address 
Correct the REPEAT location. 

ILLEGAL START ADDRESS FOR REPEAT LOOP 


No executable or DSP instructions are located between a REPEAT 
and the start address. 


Use one or more executable or DSP instructions between the 
REPEAT and the start address. 


ILLEGAL DATA BEFORE REPEAT LOOP 


Illegal data is found immediately before the loop specified by a 
REPEAT instruction. 


If an assembler directive is located before the loop, correct the 
directive. If a literal pool is located before the loop, use a .NOPOOL 
directive to prevent the literal pool output. 


When three or fewer instructions are to be repeated, an executable 
or DSP instruction must be located before the loop. 


200 Message: UNDEFINED SYMBOL REFERENCE 
Error description: Undefined symbol reference. 
Recovery procedure: Define the symbol. 

201 Message: ILLEGAL SYMBOL OR SECTION NAME 


Error description: 


Recovery procedure: 


Reserved word specified as symbol (or section name). 
Correct the symbol or section name. 
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Table D-2 Source Program Error Messages (cont) 


202 Message: ILLEGAL SYMBOL OR SECTION NAME 
Error description: \llegal symbol (or section name). 
Recovery procedure: Correct the symbol or section name. 

203 Message: ILLEGAL LOCAL LABEL 


Error description: 
Recovery procedure: 


Illegal local label. 
Correct the local label. 


Operation and Operand Errors 


300 Message: ILLEGAL MNEMONIC 
Error description: \llegal operation. 
Recovery procedure: Correct the operation. 
301 Message: TOO MANY OPERANDS OR ILLEGAL COMMENT 
Error description: Too many operands of executable instruction, or illegal comment 
format. 
Recovery procedure: Check and correct the operands and comment. 
304 Message: LACKING OPERANDS 
Error description: Too few operands. 
Recovery procedure: Correct the operands. 
307 Message: ILLEGAL ADDRESSING MODE 
Error description: lllegal addressing mode in operand. 
Recovery procedure: Correct the operand. 
308 Message: SYNTAX ERROR IN OPERAND 
Error description: Syntax error in operand. 
Recovery procedure: Correct the operand. 
309 Message: FLOATING POINT REGISTER MISMATCH 


Error description: 


Recovery procedure: 


A double-precision floating-point register is specified for a single- 
precision operation or a single-precision floating-point register is 
specified for a double-precision operation. 


Correct the operation size or the floating-point register. 


DSP Instruction Errors 


350 


Message: 
Error description: 
Recovery procedure: 
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SYNTAX ERROR IN SOURCE STATEMENT (<mnemonic>) 
There are syntax error(s) in the DSP instruction statement. 
Correct the source statement. 


Table D-2 Source Program Error Messages (cont) 


351 Message: ILLEGAL COMBINATION OF MNEMONICS 
(<mnemonic>, <mnemonic>) 
Error description: Illegal combination of DSP operation instruction is specified. 
Recovery procedure: Correct the combination of DSP operation instructions. 
352 Message: ILLEGAL CONDITION (<mnemonic>) 
Error description: Illegal condition for DSP operation instruction is specified. 
Recovery procedure: Cancel the condition or change the DSP operation instruction. 
353 Message: ILLEGAL POSITION OF INSTRUCTION (<mnemonic>) 
Error description: The DSP operation instruction is specified in an illegal position. 
Recovery procedure: Specify the DSP operation instruction in the correct position. 
354 Message: ILLEGAL ADDRESSING MODE (<mnemonic>) 
Error description: The addressing mode of the DSP operation instruction is illegal. 
Recovery procedure: Correct the operand. 
355 Message: — ILLEGAL REGISTER NAME (<mnemonic>) | 
Error description: The register name of the DSP operation instruction is illegal. 
Recovery procedure: Correct the register name. 
357. Message: ILLEGAL COMBINATION OF MNEMONICS (<mnemonic>) 
Error description: An illegal data move instruction is specified. 
Recovery procedure: Correct the data move instruction. 
371 Message: ILLEGAL COMBINATION OF MNEMONICS 
(<mnemonic>, <mnemonic>) 
Error description: The combination of data move instructions is illegal. 
Recovery procedure: Correct the combination of data move instructions. 
372 Message: ILLEGAL ADDRESSING MODE (<mnemonic>) 
Error description: An illegal addressing mode for the data move instruction operand is 
specified. 
Recovery procedure: Correct the operand. 
373 Message: ILLEGAL REGISTER NAME (<mnemonic>) 


Error description: 


Recovery procedure: 


An illegal register name for the data move instruction is specified. 
Correct the register name. 
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Table D-2 Source Program Error Messages (cont) 


Expression and Operation Errors 


400 Message: CHARACTER CONSTANT TOO LONG 
Error description: Character constant is longer than 4 characters. 
Recovery procedure: Correct the character constant. 
402 Message: ILLEGAL VALUE IN OPERAND 
Error description: Operand value out of range for this instruction. 
Recovery procedure: Change the value. 
403 Message: ILLEGAL OPERATION FOR RELATIVE VALUE 
Error description: Attempt to perform multiplication, division, or logic operation on 
relative value. 
Recovery procedure: Correct the expression. 
406 Message: ILLEGAL OPERAND 
Error description: An expression is specified at the location where floating-point data 
must be specified. 
Recovery procedure: Specify floating-point data. 
407 Message: MEMORY OVERFLOW 
Error description: Memory overflow during expression calculation. 
Recovery procedure: Simplify the expression. 
408 Message: DIVISION BY ZERO 
Error description: Attempt to divide by 0. 
Recovery procedure: Correct the expression. 
409 Message: REGISTER IN EXPRESSION 
Error description: Register name in expression. 
Recovery procedure: Correct the expression. 
411. Message: INVALID STARTOF/SIZEOF OPERAND 
Error description: STARTOF or SIZEOF specifies illegal section name. 
Recovery procedure: Correct the section name. 
412 Message: ILLEGAL SYMBOL IN EXPRESSION 
Error description: Relative value specified as shift value. 
Recovery procedure: Correct the expression. 
450 Message: ILLEGAL DISPLACEMENT VALUE 


354 


Error description: 


Recovery procedure: 
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Illegal displacement value. (Negative value is specified.) 
Correct the displacement value. 


Table D-2. Source Program Error Messages (cont) 


452 Message: ILLEGAL DATA AREA ADDRESS 
Error description: PC-relative data move instruction specifies illegal address for data 
area. 
Recovery procedure: Access a correct address according to the instruction operation size. 
(4-byte boundary for MOV.L and MOVA, and 2-byte boundary for 
MOV.W.) 
453 Message: LITERAL POOL OVERFLOW 


Error description: 


Recovery procedure: 


REPEAT Errors 


More than 510 extended instructions exist that have not output 
literals. 


Output literal pools using .POOL. 


460 Message: ILLEGAL SYMBOL 
Error description: A backward reference symbol, an undefined symbol, or a symbol 
other than a label is specified as an operand of a REPEAT, or the 
start address comes after (be at a higher address than) the end 
address. 
Recovery procedure: Correct the operand. 
461 Message: SYNTAX ERROR IN OPERAND 
Error description: Illegal operand. 
Recovery procedure: Correct the operand. 
462 Message: ILLEGAL VALUE IN OPERAND 
Error description: The distance between a REPEAT and the label exceeds the 
allowable range. 
Recovery procedure: Correct the location of the REPEAT or the label. 
463 Message: NO INSTRUCTION IN REPEAT LOOP 


Assembler Directive Errors 


500 


Error description: 


Recovery procedure: 


Message: 
Error description: 
Recovery procedure: 


No instruction is found in a loop, or no instruction is found at the end 
address. 


Write an instruction between the start and end addresses, or specify 
an address storing an instruction as the end address. 


SYMBOL NOT FOUND 


Label not defined in directive that requires label. 
Insert a label. 
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Table D-2 Source Program Error Messages (cont) 


501 Message: ILLEGAL ADDRESS VALUE IN OPERAND 
Error description: Illegal specification of the start address or the value of location 
counter in section. 
Recovery procedure: Correct the start address or value of location counter. 
502 Message: ILLEGAL SYMBOL IN OPERAND 
Error description: Illegal value (forward reference symbol, import symbol, or relative 
address symbol) specified in operand. 
Recovery procedure: Correct the operand. 
503 Message: UNDEFINED EXPORT SYMBOL 
Error description: Symbol declared for export symbol not defined in the file. 
Recovery procedure: Define the symbol. Alternatively, remove the export symbol 
declaration. 
504 Message: INVALID RELATIVE SYMBOL IN OPERAND 
Error description: Illegal value (forward reference symbol or import symbol) specified 
in operand. 
Recovery procedure: Correct the operand. 
505 Message: ILLEGAL OPERAND 
Error description: Misspelled operand. 
Recovery procedure: Correct the operand. 
506 Message: ILLEGAL OPERAND 
Error description: Illegal element specified in operand. 
Recovery procedure: Correct the operand. 
508 Message: ~ LLEGAL VALUE IN OPERAND 
Error description: Operand value out of range for this directive. 
Recovery procedure: Correct the operand. 
510 Message: ~ ILLEGAL BOUNDARY VALUE 
Error description: Illegal boundary alignment value. 
Recovery procedure: Correct the boundary alignment value. 
512 Message: ILLEGAL EXECUTION START ADDRESS 
Error description: Illegal execution start address. 
Recovery procedure: Correct the execution start address. 
513 Message: ILLEGAL REGISTER NAME 
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Error description: 
Recovery procedure: 
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Illegal register name. 
Correct the register name. 


Table D-2 Source Program Error Messages (cont) 


514 Message: INVALID EXPORT SYMBOL 
Error description: Symbol declared for export symbol that cannot be exported. 
Recovery procedure: Remove the declaration for the export symbol. 
516 Message: EXCLUSIVE DIRECTIVES 
Error description: Inconsistent directive specification. 
Recovery procedure: Check and correct all related directives. 
517 Message: INVALID VALUE IN OPERAND 
Error description: Illegal value (forward reference symbol, an import symbol, or 
relative-address symbol) specified in operand. 
Recovery procedure: Correct the operand. 
518 Message: INVALID IMPORT SYMBOL 
Error description: Symbol declared for import defined in the file. 
Recovery procedure: Remove the declaration for the import symbol. 
520 Message: © ‘ILLEGAL.CPUDIRECTIVEPOSITION ——s> 
Error description: .CPU is not specified at the beginning of the program, or specified 
more than once. 
Recovery procedure: Specify .CPU at the beginning of the program once. 
521 Message: ILLEGAL .NOPOOL DIRECTIVE POSITION 
Error description: -NOPOOL placed at illegal position. 
Recovery procedure: Place .NOPOOL following a delayed branch instruction. 
522 Message: ILLEGAL .POOL DIRECTIVE POSITION 
Error description: -POOL placed following a delayed branch instruction. 
Recovery procedure: Place an executable instruction following the delayed branch 
instruction. 
523 Message: ILLEGAL OPERAND 
Error description: Illegal .LINE directive operand. 
Recovery procedure: Correct the operand. 
525 Message: ILLEGAL .LINE DIRECTIVE POSITION 


Error description: 


Recovery procedure: 


-LINE directive specified during macro expansion or conditional 
iterated expansion. 


Change the specified position of the .LINE directive. 


File Inclusion, Conditional Assembly, and Macro Errors 


600 


Message: 
Error description: 
Recovery procedure: 


INVALID CHARACTER 
Illegal character. 
Correct it. 
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Table D-2 Source Program Error Messages (cont) 


601 Message: 
Error description: 
Recovery procedure: 


INVALID DELIMITER 
\llegal delimiter character. 
Correct it. 


602 Message: 
Error description: 
Recovery procedure: 


INVALID CHARACTER STRING FORMAT 
Character string error. 
Correct it. 


603 Message: 
Error description: 
Recovery procedure: 


SYNTAX ERROR IN SOURCE STATEMENT 
Source statement syntax error. 


Reexamine the entire source statement. 


604 Message: 
Error description: 
Recovery procedure: 


610 Message: 
Error description: 
Recovery procedure: 
611 Message: 
Error description: 


Recovery procedure: 


ILLEGAL SYMBOL IN OPERAND 
\llegal operand specified in a directive. 


No symbol or location counter ($) can be specified as an operand of 
this directive. 


MULTIPLE MACRO NAMES 

Macro name reused in macro definition (MACRO directive). 
Correct the macro name. 
MACRO NAME NOT FOUND 
Macro name not specified (MACRO directive). 


Specify a macro name in the name field of the MACRO directive. 


612 Message: 
Error description: 
Recovery procedure: 


ILLEGAL MACRO NAME 
Macro name error (.MACRO directive). 
Correct the macro name. 


613 Message: 
Error description: 


Recovery procedure: 


ILLEGAL .MACRO DIRECTIVE POSITION 


-MACRO directive appears in macro body (between .MACRO and 
-ENDM directives), between .AREPEAT and .AENDR directives, or 
between .AWHILE and .AENDW directives. 


Remove the .MACRO directive. 


614 Message: 
Error description: 


Recovery procedure: 


MULTIPLE MACRO PARAMETERS 


Identical formal parameters repeated in formal parameter 
declaration in macro definition (MACRO directive). 


Correct the formal parameters. 


615 Message: 
Error description: 


Recovery procedure: 
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ILLEGAL .END DIRECTIVE POSITION 


-END directive appears in macro body (between .MACRO and 
-ENDM directives). 


Remove the .END directive. 


Table D-2 Source Program Error Messages (cont) 


616 Message: MACRO DIRECTIVES MISMATCH 
Error description: An .ENDM directive appears without a preceding .MACRO directive, 
or an .EXITM directive appears outside of a macro body (between 
-MACRO and .ENDM directives), outside of AAREPEAT and AENDR 
directives, or outside of AWHILE and .AENDW directives. 
Recovery procedure: Remove the .ENDM or .EXITM directive. 
618 Message: MACRO EXPANSION TOO LONG 
Error description: Line with over 255 characters generated by macro expansion. 
Recovery procedure: Correct the definition or call so that the line is less than or equal to 
255 characters. 
619 Message: ILLEGAL MACRO PARAMETER 
Error description: Macro parameter name error in macro call, or error in formal 
parameter in a macro body (between .MACRO and .ENDM 
directives). 
Recovery procedure: Correct the formal parameter. 
Supplement: When there is an error in a formal parameter in a macro body, the 
error will be detected and flagged during macro expansion. 
620 Message: UNDEFINED PREPROCESSOR VARIABLE 
Error description: Reference to an undefined preprocessor variable. 
Recovery procedure: Define the preprocessor variable. 
621 Message: ILLEGAL .END DIRECTIVE POSITION 
Error description: -END directive in macro expansion. 
Recovery procedure: Remove the .END directive. 
622 Message: '))' NOT FOUND 
Error description: Matching parenthesis missing in macro processing exclusion. 
Recovery procedure: Add the missing macro processing exclusion parenthesis. 
623 Message: SYNTAX ERROR IN STRING FUNCTION 


Error description: 


Recovery procedure: 


624 "Message: 


Error description: 


Recovery procedure: 


Syntax error in character string manipulation function. 
Correct the character string manipulation function. 
MACRO PARAMETERS MISMATCH 


Too many macro parameters for positional specification in macro 
call. 


Correct the number of macro parameters. 


631 


Message: 
Error description: 


Recovery procedure: 


END DIRECTIVE MISMATCH 


Terminating preprocessor directive does not agree with matching 
directive. 


Reexamine the preprocessor directives. 
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Table D-2 Source Program Error Messages (cont) 


640 Message: SYNTAX ERROR IN OPERAND 
Error description: Syntax error in conditional assembly directive operand. 
Recovery procedure: Reexamine the entire source statement. 
641 Message: INVALID RELATIONAL OPERATOR 
Error description: Error in conditional assembly directive relational operator. 
Recovery procedure: Correct the relational operator. 
642 Message: ILLEGAL .END DIRECTIVE POSITION 
Error description: -END directive appears between .AREPEAT and .AENDR directives 
or between .AWHILE and .AENDW directives. 
Recovery procedure: Remove the .END directive. 
643 Message: DIRECTIVE MISMATCH 
Error description: -AENDR or .AENDW directive does not form a proper pair with 
-AREPEAT or .AWHILE directive. 
Recovery procedure: _Re-examine the preprocessor directives. 
644 Message: ILLEGAL .AENDW OR .AENDR DIRECTIVE POSITION 
Error description: -AENDW or .AENDR directive appears between .AIF and .AENDI 
directives. 
Recovery procedure: Remove the .AAENDW or .AENDR directive. 
645 Message: EXPANSION TOO LONG 
Error description: Line with over 255 characters generated by .AREPEAT or .AWHILE 
expansion. 
Recovery procedure: Correct the .AREPEAT or .AWHILE to generate lines of less than or 
equal to 255 characters. 
650 Message: INVALID INCLUDE FILE 
Error description: Error in .INCLUDE file name. 
Recovery procedure: Correct the file name. 
651 Message: CANNOT OPEN INCLUDE FILE 
Error description: Could not open .INCLUDE file. 
Recovery procedure: Correct the file name. 
652 Message: - INCLUDENESTTOODEEP  —it«w™S 


Error description: 


Recovery procedure: 
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File inclusion nesting exceeded 30 levels. 


Limit the nesting to 30 or fewer levels. 


Table D-2. Source Program Error Messages (cont) 


653 Message: SYNTAX ERROR IN OPERAND 
Error description: Syntax error in .|NCLUDE operand. 
Recovery procedure: Correct the operand. 
660 Message: -ENDM NOT FOUND 
Error description: Missing .ENDM directive following .MACRO. 
Recovery procedure: Insert an .ENDM directive. 
662 Message: ILLEGAL .END DIRECTIVE POSITION 
Error description: .END directive appears between .AIF and .AENDI directives. 
Recovery procedure: Remove the .END directive. 
663 Message: ILLEGAL .END DIRECTIVE POSITION 
Error description: -END directive appears in included file. 
Recovery procedure: Remove the .END directive. 
664 Message: ILLEGAL .END DIRECTIVE POSITION 
Error description: -END directive appears between .AIF and .AENDI directives. 
Recovery procedure: Remove the .END directive. 
665 Message: EXPANSION TOO LONG 
Error description: Lines with over 255 characters are generated by the .DEFINE 
directive. 
Recovery procedure: Correct the .DEFINE directive to generate lines of less than or equal 
to 255 characters. 
667 Message: SUCCESSFUL CONDITION .AERROR 
Error description: Statement including the .AERROR directive was processed in the 
.AIF condition. 
Recovery procedure: Correct the conditional statement so that the .AERROR directive is 
not processed. 
668 Message: ILLEGAL VALUE IN OPERAND 


Error description: 


Recovery procedure: 


Error in the operand of the directive. 


Specify, as the operand of this directive, a symbol defined by 
.DEFINE directive. 
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Table D-3 Source Program Warning Messages 


DSP Instruction Warnings 
700 Message: ILLEGAL VALUE IN OPERAND (<mnemonic>) 


Error description: The operand value of the DSP operation instruction exceeds the 
specifiable range. 


Recovery procedure: Correct the operand value within the specifiable range. 


701. +Message: MULTIPLE REGISTER IN DESTINATION 
(<mnemonic>, <mnemonic>) 


Error description: The same register is specified as multiple destination operands of 
the DSP instruction. 


Recovery procedure: Specify the register correctly. 


702 + Message: ILLEGAL OPERATION SIZE (<mnemonic>) 


Error description: The operation size of the DSP operation instruction or the data 
transfer instruction is illegal. 


Recovery procedure: Cancel or correct the operation size. 


703 Message: MULTIPLE REGISTER IN DESTINATION 
(<mnemonic>, <mnemonic>) 


Error description: The same register is specified as the destination registers of the 
DSP operation instruction and data transfer instruction. 


Recovery procedure: Specify the register correctly. 


General Source Program Warnings 


800 Message: SYMBOL NAME TOO LONG 

Error description: A symbol exceeded 251 characters. 

Recovery procedure: Correct the symbol. 

Supplement: The assembler ignores the characters starting at the 252nd 

character. 

801 Message: MULTIPLE SYMBOLS 

Error description: Symbol already defined. 

Recovery procedure: Remove the symbol redefinition. 

Supplement: The assembler ignores the second and later definitions. 
807 Message: ILLEGAL OPERATION SIZE 

Error description: Illegal operation size. 


Recovery procedure: Correct the operation size. 


Supplement: The assembler ignores the incorrect operation size specification. 
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Table D-3 Source Program Warning Messages (cont) 


808 Message: ILLEGAL CONSTANT SIZE 
Error description: Illegal notation of integer constant. 
Recovery procedure: Correct the notation. 
Supplement: The assembler may misinterpret the integer constant, i.e., interpret it 
as a value not intended by the programmer. 
810 Message: TOO MANY OPERANDS 
Error description: Too many operands or illegal comment format. 
Recovery procedure: Correct the operand or the comment. 
Supplement: The assembler ignores the extra operands. 
811 Message: ILLEGAL SYMBOL DEFINITION 
Error description: Specified label in assembler directive that cannot have a label. 
Recovery procedure: Remove the label specification. 
Supplement: The assembler ignores the label. 
813 Message: SECTION ATTRIBUTE MISMATCH 
Error description: A different section type is specified on section restart (reentry), or, a 
section start address is respecified at the restart of absolute section. 
Recovery procedure: Do not respecify the section type or start address on section reentry. 
Supplement: The specification of starting section remains valid. 
815 Message: MULTIPLE MODULE NAMES 
Error description: Respecification of object module name. 
Recovery procedure: Specify the object module name once in a program. 
Supplement: The assembler ignores the second and later object module name 
specifications. 
816 Message: ILLEGAL DATA AREA ADDRESS 
Error description: lllegal allocation of data or data area. 
Recovery procedure: Locate the word data or data area on an even address. Locate the 
long word or single-precision data or data area on an address of a 
multiple of 4. Locate the double-precision data or data area on an 
address of a multiple of 8. 
Supplement: The assembler corrects the location of the data or data area 
according to its size. 
817 Message: ILLEGAL BOUNDARY VALUE 


Error description: 
Recovery procedure: 


Supplement: 


A boundary alignment value less than 4 specified for a code section. 


The specification is valid, but if an executable instruction, DSP 
instruction, or extended instruction is located at an odd address, 
error 153 occurs. 


Special care must be taken when specifying 1 for code section 
boundary alignment value. 
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Table D-3 Source Program Warning Messages (cont) 


818 Message: COMMAND LINE OPTION MISMATCH FOR FLOATING 
DIRECTIVE 

Error description: When the CPU type is SH-2E or SH-3E, the ROUND=NEAREST or 
DENORMALIZE=ON command line option is specified. 

Recovery procedure: Change the specification in the ROUND or DENORMALIZE 
command line option. 

Supplement: The assembler creates the object code according to the specification 
in the ROUND or DENORMALIZE command line option. 

825 Message: ILLEGAL INSTRUCTION IN DUMMY SECTION 

Error description: An executable instruction, DSP instruction, extended instruction, or 
assembler directive that reserves data is in dummy section. 

Recovery procedure: Remove, from the dummy section, the executable instruction, DSP 
instruction, extended instruction, or assembler directive that 
reserves data. 

Supplement: The assembler ignores the executable instruction, DSP instruction, 
extended instruction, or assembler directive that reserves data in 
dummy section. 

826 Message: ILLEGAL PRECISION 

Error description: The floating-point constant does not have the same precision 
specified with the operation size. 

Recovery procedure: Correct the operation size or the precision type of the floating-point 
constant. 

Supplement: The assembler assumes the precision specified with the operation 
size. 

832 Message: MULTIPLE ‘P' DEFINITIONS 

Error description: Symbol P already defined before a default section is used. 

Recovery procedure: Do not define P as a symbol if a default section is used. 

Supplement: The assembler regards P as the name of the default section, and 
ignores other definitions of the symbol P. 

835 Message: ILLEGAL VALUE IN OPERAND 

Error description: Operand value out of range for this instruction. 

Recovery procedure: Correct the value. 

Supplement: The assembler generates object code with a value corrected to be 
within range. 

836 Message: ILLEGAL CONSTANT SIZE 
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Error description: 


Recovery procedure: 


Supplement: 
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Illegal notation of integer constant. 
Correct the notation. 


The assembler may misinterpret the integer constant, i.e., interpret it 
as a value not intended by the programmer. 


Table D-3 Source Program Warning Messages (cont) 


837 Message: SOURCE STATEMENT TOO LONG 

Error description: The length of a source statement exceeded 255 bytes. 

Recovery procedure: Rewrite the source statement to be within 255 bytes by, for example, 
rewriting the comment. Alternatively, rewrite the statement as a 
multi-line statement. 

Supplement: The assembler ignores byte number 256, and regards the 
characters starting at byte 257 as the next statement. 

838 Message: ILLEGAL CHARACTER CODE 

Error description: The shift JIS code or EUC code is specified outside character 
strings and comments, or the SJIS or EUC command line option is 
not specified. 

Recovery procedure: Specify the shift JIS code or EUC code in character strings or 
comments. Specify the SJIS or EUC command line option. 

839 Message: ILLEGAL FIGURE IN OPERAND 

Error description: Fixed-point data having six or more digits is specified in word size, 
or that having 11 or more digits is specified in long-word size. 

Recovery procedure: Reduce the digits to the limit. 

840 Message: OPERAND OVERFLOW 

Error description: Floating-point data overflows. 

Recovery procedure: Modify the value. 

Supplement: The assembler assumes + when the value is positive and— when 
negative. 

841 Message: OPERAND UNDERFLOW 

Error description: Floating-point data underflows. 

Recovery procedure: Modify the value. 

Supplement: The assembler assumes +0 when the value is negative and -O when 
negative. 

842 Message: OPERAND DENORMALIZED 

Error description: Denormalized numbers are specified for floating-point data. 

Recovery procedure: Check and correct the floating-point data. 

Supplement: The assembler creates the object code according to the specification 
(sets denormalized numbers). 

850 Message: ILLEGAL SYMBOL DEFINITION 


Error description: 
Recovery procedure: 


Symbol specified in label field. 
Remove the symbol. 
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Table D-3 Source Program Warning Messages (cont) 


851 Message: 
Error description: 


Recovery procedure: 


MACRO SERIAL NUMBER OVERFLOW 
Macro generation counter exceeded 99,999. 
Reduce the number of macro calls. 


852 Message: 
Error description: 
Recovery procedure: 


UNNECESSARY CHARACTER 
Characters appear after the operands. 
Correct the operand(s). 


854 Message: 
Error description: 


Recovery procedure: 


-AWHILE ABORTED BY .ALIMIT 


Expansion count has reached the maximum value specified by 
-ALIMIT directive, and expansion has been terminated. 


Check the condition for iterated expansion. 


870 Message: 


Error description: 


Recovery procedure: 


Supplement: 


ILLEGAL DISPLACEMENT VALUE 
Illegal displacement value. 


(Either the displacement value is not an even number when the 
operation size is word, or the displacement value is not a multiple of 
4 when the operation size is long word.) 


Take account of the fact that the assembler corrects the 
displacement value. 


The assembler generates object code with the displacement 
corrected according to the operation size. 


(For a word size operation the assembler discards the low order bit 
of the displacement to create an even number, and for a long word 
size operation the assembler discards the two low order bits of the 
displacement to create a multiple of 4.) 


871 Message: 
Error description: 


Recovery procedure: 


Supplement: 


PCRELATIVEINDELAYSLOT  ~— ; 


Executable instruction with PC relative addressing mode operand is 
located following delayed branch instruction. 


Take account of the fact that the value of PC is changed by a 
delayed branch instruction. 


The assembler generates object code exactly as specified in the 
program. 


874 Message: 
Error description: 


Recovery procedure: 
Supplement: 
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CANNOT CHECK DATA AREA BOUNDARY 


Cannot check data area boundary for PC-relative data move 
instructions. 


Note carefully the data area boundary at linkage process. 


The assembler only outputs this message when a data move 
instruction is included in a relative section, or when an import 
symbol is used to indicate a data area. 


Table D-3 Source Program Warning Messages (cont) 


875 Message: CANNOT CHECK DISPLACEMENT SIZE 

Error description: Cannot check displacement size for PC-relative data move 
instructions. 

Recovery procedure: Note carefully the distance between data move instructions and data 
area at linkage. 

Supplement: The assembler only outputs this message when a data move 
instruction is included in a relative section, or when an import 
symbol is used to indicate a data area. 

876 Message: ASSEMBLER OUTPUTS BRA INSTRUCTION 

Error description: The assembler automatically outputs a BRA instruction. 

Recovery procedure: Specify a literal pool output position using .POOL, or check that the 
program to which a BRA instruction is added can run normally. 

Supplement: When a literal pool output location is not available, the assembler 
automatically outputs literal pool and a BRA instruction to jump over 
the literal pool. 

880 Message: END NOT FOUND 

Error description: No .END in the program. 

Recovery procedure: Add an .END. 

881 Message: ILLEGAL DIRECTIVE IN REPEAT LOOP 


Error description: 


Recovery procedure: 


Supplement: 


An illegal assembler directive was found in a loop. 
Delete the directive. 


If a directive that reserves a data item or a data area, an .ALIGN 
directive, or an .ORG directive is used in a loop, the assembler 
counts the directive as one of the instructions to be repeated. 
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Table D-4 Fatal Error Messages 


Fatal Errors 


901 Message: SOURCE FILE INPUT ERROR 
Error description: Source file input error. 
Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 
902 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. (Unable to process the temporary information.) 
Recovery procedure: Subdivide the program. 
903 Message: LISTING FILE OUTPUT ERROR 
Error description: Output error on the list file. 
Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 
904 Message: OBJECT FILE OUTPUT ERROR 
Error description: Output error on the object file. 
Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 
905 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. (Unable to process the line information.) 
Recovery procedure: Subdivide the program. 
906 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. (Unable to process the symbol information.) 
Recovery procedure: Subdivide the program. 
907 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. (Unable to process the section information.) 
Recovery procedure: Subdivide the program. 
908 Message: SECTION OVERFLOW 
Error description: The number of sections exceeded 65,535. 
Recovery procedure: Subdivide the program. 
909 Message: ‘SYMBOL OVERFLOW 
Error description: The number of symbols exceeded 65,535. 
Recovery procedure: Subdivide the program. 
910 Message: SOURCE LINE NUMBER OVERFLOW 
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Error description: 


Recovery procedure: 
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The number of source program lines exceeded 65,535. 
Subdivide the program. 


Table D-4 Fatal Error Messages (cont) 


911 Message: IMPORT SYMBOL OVERFLOW 
Error description: The number of import symbols exceeded 65,535. 
Recovery procedure: Reduce the number of import symbols. 
912 Message: EXPORT SYMBOL OVERFLOW 
Error description: The number of export symbols exceeded 65,535. 
Recovery procedure: Reduce the number of export symbols. 
933 Message: ILLEGAL ENVIRONMENT VARIABLE 
Error description: The specified target CPU is incorrect. 
Recovery procedure: Correct the target CPU. 
935 Message: SUBCOMMAND FILE INPUT ERROR 
Error description: Subcommand file input error. 
Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 
936 Message: ‘SUPPLEMENT FILE OUTPUT ERROR ; 
Error description: Supplement file output error. 
Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 
950 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. 
Recovery procedure: Separate the source program. 
951 Message: LITERAL POOL OVERFLOW 
Error description: More than 100,000 internal symbols are used for literal pools. 
Recovery procedure: Separate the source program. 
952 Message: LITERAL POOL OVERFLOW 
Error description: Literal pool capacity overflow. 
Recovery procedure: Insert unconditional branch before overflow. 
953 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. 
Recovery procedure: Separate the source program. 
954 Message: LOCAL BLOCK NUMBER OVERFLOW —_ 


Error description: 


Recovery procedure: 


The number of local blocks that are valid in the local label exceeded 
100,000. 


Separate the source program. 
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Table D-4_ Fatal Error Messages (cont) 


956 Message: EXPAND FILE INPUT/OUTPUT ERROR 
Error description: File output error for preprocessor expansion. 


Recovery procedure: Check the hard disk for adequate free space. Create the required 
free space by deleting unnecessary files. 


957 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. 


Recovery procedure: Separate the source program. 
958 Message: MEMORY OVERFLOW 
Error description: Insufficient memory. 


Recovery procedure: Separate the source program. 
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Appendix E Differences from Version 3.1 


The differences between this new version (V.4.0) and the former version (V.3.1) are described 
below. 


E.l1 CPU 


This version includes assembly functions for the SH-2E, SH-4, and SH3-DSP in addition to the 
SH-1, SH-2, SH-3, SH-3E, and SH-DSP, and the following items are added or changed. 


* Reserved words 

¢ Executable instructions 

¢ .CPU assembler directive 

* CPU command line option 

* SHCPU environment variable 


References: 


Reserved words 
— Programmer's Guide, 1.2, "Reserved Words" 
Executable instructions 
— Programmer's Guide, 3, "Executable Instructions" 
.CPU assembler directive 
— Programmer's Guide, 5.2.1, "Assembler Directive Related to CPU" 
—CPU command line option 
— User's Guide, 2.2.1, "Target CPU Command Line Option" 
SHCPU environment variable 
— User's Guide, 1.3, "SHCPU Environment Variable" 


E.2 Object Format 


In the new version, ELF/DWARF object format is supported in addition to those supported in the 
former version. 


The assembler outputs ELF/DWARF supplement information when outputting debug 
information. 


References: 


Debug information 
— Programmer's Guide, 5.2.6, "Object Module Assembler Directives", OUTPUT 
— User's Guide, 2.2.2, "Object Module Command Line Options", -DEBUG 
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E.3 Constants 


In the new version, double-precision floating-point constants can be used in addition to single- 
precision floating-point constants. 


* Double-precision floating-point constants are used in the SH-4. 
Reference: 


Floating-point constants 
— Programmer's Guide, 1.4.3, "Floating-Point Constants" 


E.4 Changed Assembler Directives 


Table E-1 lists the double-precision registers and operation sizes added to assembler directives 
and assembler statements related to floating-point constants in the new version. 


Table E-1_ Changed Assembler Directives and Statements 


Assembler Directive Reference in 

or Statement Function Programmer's Guide 
.FREG Floating-point register types §.2:3 

-FDATA Double-precision operation size 5.2.4 

-FDATAB : Double-precision operation size 5.2.4 

_FRES Double-precision operation size 5.2.4 


E.5 Added Command Line Options 
Table E-2 lists the command line options added to the new version. 


Table E-2 Added Command Line Options 


Command Line Option Function Reference in User's Guide 
ROUND Selection of floating-point data 2.2.10 

rounding mode 
DENORMALIZE Selection of how to handle 2.2.10 


denormalized numbers in 
floating-point data 
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Reference: 


Floating-point constants 
— Programmer's Guide, 1.4.3, "Floating-Point Constants" 
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Appendix F ASCII Code Table 


ASCII Code Table 


Table F-1 


Upper 4 Bits 


0 


Lower 4 Bits 


DLE 


NUL 
SOH 
STX 


DC2 


ETX 


EOT 


NAK 


ENQ 
ACK 


CAN 
EM 


BS 
HT 
LF 
VT 

a 


SUB 


ESC 
FS 
GS 


CR 
SO 


Sl 


RS 


US 


374 HITACHI 


Index 


HITACHI 375 


AO) ~-n-n 2-22 n--n nnn anne nn nnn nn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn n nnn nnnennneenns 16, 83, 96, 101 
AOG -n-------2 2-2-2 2--n nn nena nnn nnn nn nnn nnn nnn nnn nnn neem nen nn nn nn cnnnncenne 16, 101 
A] won anna nanan nnn nnn nnn nn nnn nnn nn nn nnn nnn nn nnn nn nn nnn nee nnn nnn nnn n cnn nn cenns 16, 96, 101 
AIG wnn--nn--n nn nnn nnn nn nena nnn nnn nnn nn nnn nnn nn nn nnn nnn nnn neem nnn nn en nnn ec cenns 16, 101 
-ABORT -----------------------n nn nnn nnn nn nnn nnn nn nnn nnn nnn nen nnn nnn en nnn nnnenns 318 
absolute address -------------------------------------------------------------------- 50 
absolute address section-------------------------------------------------------- 50 
absolute address section declaration ----------------------------------------- 111 
absolute address symbol ------------------------------------------------------- 52 
absolute address value---------------------------------------------------------- 52, 115 
absolute path ------------------------------------------------------------------------ 202, 203 
absolute value ----------------------------------------------------------------------- 52 
ADD-------------------------------------- 2-29-29 n nnn nnn nnn nnn nnn nnn nn nn nn nennne 66, 69 
ADDO ~------------ 2-29-29 n nnn anna nena nnn nnn nnn nnn nnn nnn nnn nen nnn nn nn en nen nee nnenne 69 
address calculation ----------------------------------------------------------------- 86 
address symbol --------------------------------------------------------------------- 16 
absolute address symbol ------------------------------------------------------- 52 
relative address symbol -------------------------------------------------------- 52 
addressing mode ------------------------------------------------------------------- 62 
executable instruction mnemonic and addressing mode combination -- 67 
GBR indirect with displacement---------------------------------------------- 62 
GBR indirect with index------------------------------------------------------- 62 
immediate------------------------------------------------------------------------ 63 
PC relative with displacement ------------------------------------------------ 62 
register direct-------------------------------------------------------------------- 62 
register indirect ----------------------------------------------------------------- 62 
register indirect with displacement ------------------------------------------ 62 
register indirect with index---------------------------------------------------- 62 
register indirect with post-increment ---------------------------------------- 62 
register indirect with pre-decrement ----------------------------------------- 62 
symbol --------------------------------------------------------------------------- 63, 65 
ND) \ eee 69 
AELIF ------------------------------------ 2-92-9229 2-22 nn nnn nn nnn anna nnn nena nnn nn =e 219 
ND) ON) ee ee ee 219, 222 
AEND I ------------------------ 2-2-2229 nn nnn nnn nnn nnn nn nnn nnn nn nn nnn nnn nn nn nnenes 219, 222 
AENDR ----------------2 22-22-2922 nnn nnn nn nnn nnn nnn n nen nnn n nnn nnn en nn nnn nn nenn nes 
AENDW  -------------------2---2 22-222 -n nnn nnn nn nnn cnn nnn c nnn nner cnn nncces 
AERROR -------------------2 22-22-22 nanan nnn nnn nnn nen cnn nnn nce nn nen nncnnnnce= 
DAT -----------9 2-22 n nn nnn nnn nn nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn cnn ncn nnnnce= 
-AIF DEF -------------------------n 2-2 n nena nnn nnn nnn nn nnn nnn nnn nnn n nnn n nnn anne 
ALIGN ----------------------------------- 22-22-2222 nnn nanan nnn nnn nn nnn nnn e nnn n cen 
-ALIMIT ------------------------ 2-22-22 n nn nnn nnn nn nnn nnn nnn nn nnn nnn nn nn nn cen nn cccnne 
-AREPEAT -~------------22--- 222-2 nnn nnn nnn anna nnn nnn nnn ncn n nn nn nce nn nnn nnnenn nee 
AND. ----------------2 2-22-22 22n nnn nnn nnn n nnn nnn nn nn cn cence cnn n nnn e nnn ennnnnnnn 
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assemble listing --------------------------------------------------------------------- 4 
assemble listing assembler directive------------------------------------------ 178 
assemble listing column count setting---------------------------------------- 185, 3 
assemble listing command line option --------------------------------------- 295 
assemble listing line count setting -------------------------------------------- 185, 3 
assemble listing output control ------------------------------------------------ 179, 2 
assemble listing output example --------------------------------------------- 341 

assembler--------------------------------------------------------n nnn nn nnn nena nnn 3,6 

assembler directive ----------------------------------------------------------------- 12,10 
assembler directive mnemonic ----------------------------------------------- 103 

assembly-language source program ---------------------------------------------- 4,6,7 

-ASSIGN ----------------------- 7-2-2 none nn nnn nnn nnn nnn nnn enna nn nnn nn nnn nnn nena LZ 

-ASSIGNA ------------------------ n-nonane nn nnn nnn nn nnn nnn nnn nnn nn nnn cence nn en nen 212 

-ASSIGNA ----------------------------- 7-2-2222 n nnn nnn nnn nnn nn nnn nnn nnn nn enna nnn ne- 311 

-ASSIGNC ------------------------------- 22-22-22 nnn nn nnn nnn nnn enna nnn nn nana nnn 215 

-ASSIGNC --------------------------------------------------------------------------- 313 

-AUTO_LITERAL ----------------------------------------------------------------- 324 

AWHILE ---------------------------- 2-2-2 nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nen ecnne 226 

AX wn nnnn nn nena nn nnn nn nn nn nnn nnn nn nnn nn nnn nn nnn nnn nnn nnn nnn nnn nn nnn nnn nn nnn nnn nena 101 

os 101 

AZ wnnnnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn 

B 

B! ~---------------------- 9-2-2 - 2a anna nnn nn nnn nnn nnn nnn nn nnn nnn nnn nnn nen cence 19 

backward ---------------------------------------------------------------------------- 55 

backward reference ----------------------------------------------------------------- 56 

BF ----------------------------- 2-9 n-nonane nn nnn nnn nnn nnn nnn nn nnn nnn nnn nn nnn nnn nn anna ee 71, 85 

13) A ee 73,85 

bias ------------------------------------------------------------------------------------ 24 

bias value ---------------------------------------------------------------------------- 24 

binary --------------------------------------------------------------------------------- 19, 19 

blank line output to source program listing ------------------------------------- 191 

boundary alignment 
boundary alignment value ----------------------------------------------------- 109 
correcting of location counter value ------------------------------------------ 30, 11 

BRA  ----------------------9- 2-2 n nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nn nanan 71, 85 

BRAF -------------------------------------- 72-22-2222 nnn nnn nnn nnn nnn nanan nana 73,85 

branch instruction ------------------------------------------------------------------ 71, 73 
delayed branch instruction ----------------------------------------------------- 84, 85 

BSR --------------------------- 22a 2a nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn 71, 85 

BSREI ------------------------------------------ 27-22-22 222-222 n 2 enon nnn nnn enna enn 73, 85 

BI ----------------------------------------- 2-22-22 ono nn nnn nnn nn nnn nnn nnn nnn nnn nn ne == 71, 85 

BTS ------------------------------- 2-3-2 --nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nen nnn 73, 85 


06 
96 


100, 101 
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C 


character constant ------------------------------------------------------------------ 20 
character preprocessor variable definition -------------------------------------- 215, 313 
character string --------------------------------------------------------------------- 40 
character string data area reservation---------------------------------------- 152 
character string data area reservation with length ------------------------- 154 
character string data area reservation with zero terminator -------------- 156 
character string data block reservation -------------------------------------- 135 
character string data reservation --------------------------------------------- 133 
character string data reservation with length ------------------------------- 138 
character string data reservation with zero terminator -------------------- 140 
character string length count-------------------------------------------------- 250 
character string manipulation function -------------------------------------- 246, 249 
character string search --------------------------------------------------------- 252 
CLRMAC ----------------------------------9 2-2-2 n on nnn nnn nnn nnn nnn nen n nnn ennncnne 72 
CLRS ----------------------------- 2-9-2222 n nnn nnn nnn nnn nnn nnn nnn nnn snes nen n nnn nees 77 
CLRT ------------------- 2-2-2 n-nonane nn nn nnn nnn nnn nnn nnn nn nnn neem nen nnn nn nnn nennnne 72 
CMP/EQ -~----------------2 22a on nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn n nnn cnn cnnnces 66, 69 
CMP!/GE ------------------------- 2-2-2 n 29 nnn n nn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn n nee 69 
CMP/GT ------------------------- nnn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn n nee 69 
CMP/HI --------------------------- 2-2-2 nena nnn nnn nnn nn nnn nnn nnn nnn nen nnn nnn nn nen 69 
CMP/HS ---------------------------- 2-22-22 22a nnn nnn nnn nnn nen nen n nn nnn nnn n nen nnes 69 
CQ ae eee 69 
CMP/PZ ------------------------------------ 22-2 n n-nonane nnn nnn nnn nnn nnn nnn nnn nnn 69 
CMP/STR ------------------------ 2-22-7222 2-2 nnn nnn nnn nnn nnn nnn nnn nnn neem n nnn nn 69 
code section ------------------------------------------------------------------------ 45 
code section declaration ------------------------------------------------------- 109 
coding 
coding of source statement ---------------------------------------------------- 13 
coding of source statements across multiple lines-------------------------- 15, 94 
coding of symbol --------------------------------------------------------------- 18 
-COLUMNS ------------------------------- 2-22-2222 nn nnn n nnn nn nena nnn -n naan =a ------ 307 
command line----------------------------------------------------------------------- 281 
command line option -------------------------------------------------------------- 285 
comment ----------------------------------------------------------------------------- 12, 14, 61 
comment in macro -------------------------------------------------------------- 246 
comment of source statements across multiple lines----------------------- 15 
common section -------------------------------------------------------------------- 47 
common section declaration--------------------------------------------------- 109 
compller ----------------------------------------------------------------------------- 6,7 
conditional assembly ------------------------------------------------------2----2--- 205 
conditional assembly directive ----------------------------------------------- 211 
conditional assembly with comparison -------------------------------------- 207, 219 
conditional assembly with definition 
conditional iterated expansion --------------------------------------------------- 
maximum count specification ------------------------------------------------ 
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constant ------------------------------------------------------------------------------ 19,52 


constant symbol --------------------------------------------------------------------- 16 
control character -------------------------------------------------------------------- 133, 136, 138, 140 
CPU ----------------------------------------------------------------------------------- 106, 283, 288 
CPU --------------------------------------- 2-2-2 - ono nnn nn nnn enna nnn nnn nen n- === 106 
-CPU ----------------- 2-2-2 --- nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nn nnn nnn nnn neces 288 
-CROSS_REFERENCE---------------------------------------------------0------=+ 300 
cross-reference listing -------------------------------------------------------------- 344 
cross-reference listing output control ---------------------------------------- 179, 300 
D 
DP! ----------------------- 29-2222 - nnn nn nn nn nnn nnn nn nnn nnn nnn nnn nnn nn nnn nenennenns 19 
Da ----------------------- 2-22-22 nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nn nnn nn nen nenennnns 101 
DATA ~----------------- 2-7-9 nnn nn nena nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nn enn ennene 128 
data area reservation --------------------------------------------------------------- 149 
DATAB ----------------------------- 2-22-2222 nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnnnnne 130 
data move instruction -------------------------------------------------------------- 67, 74, 76, 78, 80, 93, 
99 
single data move instruction --------------------------------------------------- 93, 102 
X data move instruction -------------------------------------------------------- 93, 102 
Y data move instruction -------------------------------------------------------- 93, 102 
data section ---------------------------------------------------------------------2-0-- 46 
data section declaration -------------------------------------------------------- 109 
data structure ------------------------------------------------------------------------ 48 
data structure represented using dummy section --------------------------- 48 
DBR ----------------------- 2-2 nn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn ennes 16, 80 
DCF ----------------------- 2-22 nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn n nnn nenne 92 
DCT  ------------------------- 22a nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nn nen ennes 92 
DEBUG --------------------------- 2-2 22-2 nn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn n enn nn eens 171 
-DEBUG ---------------------------------------- 27-92-22 222222222 onan nnn nano 292 
debug information ------------------------------------------------------------------ 170 
debug information output control --------------------------------------------- 168, 292 
supplement debug information file (ELF/DWARF supplement 
information)---------------------------------------------------------------------- 169, 292 
decimal ------------------------------------------------------------------------------- 19, 196 
decrement ---------------------------------------------------------------------------- 63 
.DEFINE ----------------------------------- 2-22-2222 n on nnn nnn enna anne nena nn ne ee 217 
-DEFINE -------------------------------- 22-922 nnn nnn nnn nnn nnn nnn enna nnn nnn nena 315 
delay slot instruction --------------------------------------------------------------- 85 
delayed branch instruction -------------------------------------------------------- 84, 85 
-DENORMALITZE ------------------------------------------------------------------ 332 
denormalized numbers ------------------------------------------------------------- 22.23. 25>, 20, 532 
DQ ---------------------------- oon n nnn nnn nnn nnn nnn nnn nnn nn nn nnn nnn nnn nnn nen nnnne 96 
disp ----------------------------------------------------------------------------------- 62, 64, 68 
displacement------------------------------------------------------------------------- 62, 63 
correcting of displacement ---------------------------------------------------- 66 
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DIVOU ------------------------------ 2-2-2222 n anna nnn nnn nnn nnn nnn nnn nnn nnn nen n anne 69 
DIV | ----------------------------------- 2-22-2222 anna nnn nnn nnn nnn nnn nn nnn nnn n nn nn= 69 
division by Zer0 -------------------------------------------n nnn nnn n nn nnn enna nen nn n= 39 
DMULS ------------------------------------ 2-22 -n n-nonane nnn nnn nnn nnn nnn n nnn enne= 73 
DMULLU ------------------------------- 2-92-22 nnn nnn nnn nnn nnn nnn nnn n nnn nnn nnnnnenns 73 
double precision -------------------------------------------------------------------- 22, 23, 24, 25, 61 
D)p ---------------------- 2-2 n-nonane nn nnn nnn nnn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnnne 96 
DR) --------------------------------- 2-22 -- n-ne nn nnn nnn nnn nnn nnn nnn nnn nnn n nnn nnnne 16, 80 
DS ------2--------- n-nonane nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn cnn nnn nnn nnenns 101 
DSP instruction --------------------------------------------------2--2--2 222202202 --- 91,95 
DSP operation instruction ---------------------------------------------------- 95 
DS) ee ooo 16, 83 
D1 -------------------------------- 2-22-22 nn nnn nn nn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nn= 73 
DU ------------------------$ 22-2 nn nnn nnn nnn nn nnn nnn nn nnn nn nn nnn n nnn nn nn nnn nnncenee 96 
dummy section ----------------------------------------------- 20-2 --n nnn nen nnn anne n= 48 
CaUtiON------------------------------------------ 22-22-22 2a nnn nnn nn nnn nena nanan 50 
data structure represented using dummy section --------------------------- 48 
dummy section declaration ---------------------------------------------------- 109 
DWARE --~------------------ 2-2-2222 n nnn nnn nn nn nnn nnn nnn nnn nen nen nnn nnnnenne 169, 292 
) ee 101 
Dy -------------------------------- = 22-2 nnn n nnn nnn nnn nnn nn nn nnn nnn nn nnn enna nana ene 101 
ee 96, 101 
E 
editor -------------------------------------- 2-22 - nnn nnn nnn nn nnn nnn n nnn nena nnn n= - == 6 
ELF -------------------------------------------- 2222-92-92 22-2 on nnn nnn nnn nnn anna nnn n= 169, 292 
emulator ----------------------------------------------------------------------------- 7 
END -----------------------------------2---------2---------2---------2--------------- 198 
endian -------------------------------------------------------------------------------- 173, 294 
endian selection ----------------------------------------------------------------- 173, 294 
.ENDIAN ------------------------- 2222-99-22 2 2nn nnn nnn nnn nnn nena enna n-an-------- 
-ENDIAN -------------------------2n nnn nnn nnn nnn nena nnn nnn nnn anne nnn nnn n naan nanan 
END) --------------------2-- 20-22 n nnn nn nnn nnn nnn nnn nnn nnn nnn n nnn n nnn nn nena nn n- 
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€XP0flt ------------------------------------------------------- === 2 === 2-222 --- 22a none 58 
export assembler directive ----------------------------------------------------- 160 
export symbol ------------------------------------------------------------------- 58 
export symbol declaration------------------------------------------------------ 58, 161, 165 
-EXPORT --------------------2 222 nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nena naan nnn enn 161 
eXPIeSSiON ---------------------------------------------------------------------------- 31 
element --------------------------------------------------------------------------- 31 
internal processing -------------------------------------------------------------- 39 
notes on expressions ------------------------------------------------------------ 39 
operation precedence ----------------------------------------------------------- 33 
extended instruction ---------------------------------------------------------------- 68, 258, 272 
external ------------------------------------------------------------------------------- 55 
external definition ------------------------------------------------------------------ 58 
external reference ------------------------------------------------------------------- 56 
external reference value------------------------------------------------------------ 52 
EXTS ---------------------------------------- 2-92-22 222 nnn n anne n nnn nnn nnn nnn nnn nnn 69 
EXTU ------------------------------------ 2-9-2 2-22-22 22a nnn nnn nnn nnn nnn nnn nen nnn 69 
F 
FABS ----------------------------------------------- 2-22-22 22a 2a nnn nnn nnn nnn nnn 75, 79, 81 
FADD -------------------------------------------------------------------------------- 75, 79, 81 
FCMP/EQ ----------------------------- 2-22-22 nnn nnn nnn nnn nnn nnn nn nnn nnn nnn mene nnn ee 75, 79, 81 
FCMP/G1 -------------------------------------- 2-22 22a noon nnn nn nnn nnn nnn nnn nnn nnn 75, 79, 81 
FCNVDS -------------------------- 7-2-2222 nn nn nn nnn nnn nnn nn nn nnn nnn neem nnn nnn nnnn= 82 
FCNVSD.----------------------- 2-2-9 - 2-2 nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nen nn ne 82 
FDATA ------------------------------- 22-222 nnn nnn nnn nnn nn nnn nnn n nnn n nnn nnn enn nn= 142 
-FDATAB ---------------- 7-97-22 anon nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nn nn nnnnnn nn 144 
FDI\V ---------------------------------------- 2-722-222-2222 nn nnn nnn nnn nnn nnn n nnn ee 75, 79, 81 
file format ---------------------------------------------------------------------------- 282 
file inclusion ------------------------------------------------------------------------- 201, 202 
nesting of file inclusion -------------------------------------------------------- 202 
file name ----------------------------------------------------------------------------- 282 
file specification format------------------------------------------------------------ 282 
FIPR ------------------------------------------- 2-922-222-2222 noon nnn n nnn nnn nanan oe 81 
fixed-point data format------------------------------------------------------------- 28 
fixed-point data reservation---------------------------------------------------- 147 
fixed-point number ----------------------------------------------------------------- 26 
FLDIO ------------------------------------------------ 22-222 n 22 nn nnn anna nnn nnn nn eee 74, 78 
FLDI1 -------------------------------------------------------------------------------- 74, 78 
FLDS --------------------------------------------- 2-22 2-92-22 onan nnn nn nnn nnn nnn nnn 75,79 
FLOAT ----------------------------------------------2 2-922-922-2222 noon nnn nanan 75, 79, 82 
floating-point constant ------------------------------------------------------------- 21 
floating-point data ----------------------------------------------------------------- 22 
floating-point data format------------------------------------------------------ 23 
floating-point data area reservation ------------------------------------------ 158 
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floating-point data reservation ------------------------------------------------ 142 
floating-point register name alias definition ----------------------------------- 125 
FMAC --~---------------------- 2-2-2222 nanan n nn nnn nn nnn nnn nn nnn nn nen en ence nen nenes Taby Io 
FM) ------------------- n-ne nnn enna nn nnn nnn nnn nnn nnn nn nn nee nnn nn enna ne nen en ne nens 74, 78, 80 
(| a ee ae ee aaa as 75, 79, 81 
FNEG --------------------------- 2a nnn nn nn nnn nnn nnn nnn nnn ne nen en nn enn nenennn eens 75, 79, 81 
FORM ------------------------2-9-n-- n-ne enna nnn nnn nnn nnn nnn nnn meneame nen nnnenn= 185 
formal parameter ------------------------------------------------------------------- 236, 238 

default --------------------------------------------------------------------------- 238 
forward------------------------------------------------- 2-22-2222 222222 nnn nn nena nnn e- 55 
forward reference------------------------------------------------------------------- 56 
FPSCR --------------------------- 222-22 n nnn nnn nnn nnn nnn nnn nnn ences enn enns 16, 74, 78 
FPUL --------------------- 2-202 -n 2a nn nnn nnn nn nnn anna nn nn nn nn nnn nn nn nn nn nen n en nn eens 16, 74, 78 
fraction part ------------------------------------------------------------------------- 24, 28 
FRCHG -------------------------- 29-2222 n nn nnn n nn nnn nn nnn nnn nn nnn nnn nnn nnn neces 82 
JFREG -------------------------- 222-22 n nanan n nn nnn nnn nn nn nn nnn nn nnn nen en nn nc nenene 125 
.FRES -------------------------- 2-29-2222 2-222 n nnn nnn nn nn nn nn nnn nnn nnn en enncnenene 158 
F Ril ----------------- 2-2-2222 n nana nnn nnn nnn nn nnn enna nn nn nn nnn nn en nn nn nn ne nen en en nenene 16, 74, 78 
FSCHG ---------------------------------- 2-2-2222 n nn nn nnn nnn nn nn nn nn nn nnn nn en nnn ene= 82 
scare ttoeteetncenrncenieouncdnmentneet 79, 81 
ances eprint domino niamarcinlaeichaaenanioin 75, 79 
Sf a a a ene 75, 79, 81 
FT RC --------------------------- 7-2-2 -2n nnn nn nnn nnn nnn nn nn nnn nnn nnn nn nn nn cence 75, 719, 82 
BT wane ncenencaraininnrernnnannanaiaiiensimnaamaitniaaeaicaianenatnucaiat 81 
F Vi\---------------------------- 2-22-2222 nnn nnn nnn nnn nn nnn nn nn nnn nnn nn nnn nn nen nn nes 16, 80 
G 
Oo Cee oo 16, 62, 68 

GBR indirect with displacement---------------------------------------------- 62 

GBR indirect with index------------------------------------------------------- 62 
GLOBAL --------------------2 22-2 nn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nen nn= 165 
H 
Se ooo 19 
header for source program listing------------------------------------------------ 187 
HEADING ------------------------------------ 222-22 n nono nn nena enna nn nn naan ne nnnnee 187 
hexadecimal ------------------------------------------------------------------------- 19, 196 
I 
iMM ---------------------------------------------------------------------------------- 68, 258 
immediate --------------------------------------------------------------------------- 63, 66 
imp ott -------------------------------------------------------------------------------- 59 

import assembler directive ---------------------------------------------------- 160 
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import symbol ------------------------------------------------------------------- 52, 59 
import symbol declaration ----------------------------------------------------- 59, 163, 165 
IMPORT -------------------------------- 722-22 n nnn nnn nnn nnn nnn nnn nnn nanan enn 163 
INCLUDE --------------------------------------------------------------------------- 202 
-INCLUDE -------------------------------------------------------------------------- 309 
include file directory specification ----------------------------------------------- 309 
inclusion ----------------------------------------------------------------------------- 201 
increment ---------------------------------------------------------------------------- 63 
infinity -------------------------------------------------------------------------------- 22,29 
input source file --------------------------------------------------------------------- 281 
INSTR ------------------------------------ 20-2222 n nn nnn nn nnn nena nnn nnn nn nena nn nn nee 252 
integer 
default radix for integer constants -------------------------------------------- 196 
integer constant------------------------------------------------------------------ 19 
integer data block reservation ------------------------------------------------- 130 
integer data reservation -------------------------------------------------------- 128 
integer part -------------------------------------------------------------------------- 21 
integer preprocessor variable definition ----------------------------------------- 212, 311 
internal processing of expression ------------------------------------------------- 39 
internal symbol ---------------------------------------------------------------------- 18 
IS --------------------------------------------------- 7-72-72 +2 2-2 == ------------------- 101 
iterated expansion ------------------------------------------------------------------ 209, 224 
termination ----------------------------------------------------------------------- 231 
i a ee 101 
ly ----------------------------- 2-2-2 nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nn =e 101 
IZ --------------------------------------------- 29-22-2222 nnn nnnnnnn nnn nanan nae 100, 101 
J 
Japanese character ------------------------------------------------------------------ 13, 20, 40, 320, 321, 
aaa 
IMP ----------------------------------- 2-7-9222 -- 22 n nnn nnn nena nnn nn nena enna =n === 71, 85 
\N) Ce es 71, 85 
K 
keyword specification -------------------------------------------------------------- 247 
L 
label ----------------------------------------------------------------------------------- 12,13 
LDC ----------------------------------------------------- 7-2-9 2-2-2 222-2 222222222 2-2=- 72, 77, 82, 84, 85 
LDRE --------------------------------------------------------------------------------- 83, 272 
LDRS ------------------------------------- 7-7-2 2-22-22 o non n nnn enna nanan nnn 83, 272 
LDS ------------------------- 72-222 n nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nn nnn n nnn 72,75, 79, 84 
LDTLB ----------------------------------------------- 2-7-2 22-222 n nnn nnn nn nnn nn nnn 77 
.LEN ---------------------------------- 7-2-2222 nnn nn nnn nnn nn nnn nnn nnn nnn nnn nana nn 250 
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librarian------------------------------------------------------------------------------ 6,7 


library file --------------------------------------------------------------------------- 6,7 
line 

line length ----------------------------------------------------------------------- 337 

maximum length---------------------------------------------------------------- 13 
line number ------------------------------------------------------------------------- 176 

line number modification ------------------------------------------------------ 176 
LINE ----------------------- 2-222 n nnn nnn nena nnn nnn nnn nnn n nnn nnn n nnn nnn nen nnn n nnn 176 
-LINES ---------------------------------------- 22-22-2222 nanan nnn nn nnn nnn nnn nnn enna 306 
linkage editor ----------------------------------------------------------------------- 6,7 
LIST ----------------------------------------------------- 2-222-222-2222 nnn nnn nn nnn 181 
-LIST -------------------------------------------------- 2-22 - non nn nnn nnn nena nanan n= 296 
listing file---------------------------------------------------------------------------- 282 
listing output file specification --------------------------------------------------- 296 
literal pool 

automatic literal pool generation function ---------------------------------- 257 

extended instruction related to automatic literal pool generation-------- 258 

size mode for automatic literal pool generation ---------------------------- 258, 324 
load module ------------------------------------------------------------------------- 6,7 

S-type-format load module ---------------------------------------------------- 6,7 
local label---------------------------------------------------------------------------- 42 
location ---------------------------------------------------------------- 2222-2 -------- 29 
location counter--------------------------------------------------------------------- 29 

value of location counter ------------------------------------------------------ 29 

correcting of location counter value ----------------------------------------- 30, 116 

location-counter-value setting ------------------------------------------------ 114 
logic operation instruction -------------------------------------------------------- 70 
M 
MO ---------------------------- 2-92-22 n nnn nnn nnn nn nn nnn nnn nn nnn nn nnn nn nnn n nee 16, 96, 101 
M1 -------------------------------------------- 2-2-2 2-222 nnn nn nnn nnn nnn nena nena nae 16, 96, 101 
ON Oe ooo 69, 73 
UNG) 5 eee 16, 68 
NO) ee 16, 68 
MACIO ------------------------------ 2-2 - $= =n nnn nn nnnnnnnnnnn nn nn nn nnn nnn anne anne 235 

character string manipulation function -------------------------------------- 246, 249 

comments in Macr0------------------------------------------------------------- 

macro body ----------------------------------------- 2-22 -n none nn nnn nnn nnn nena 

macro Call ------------------------------------------------------------------------ 

macro definition ---------------------------------------------------------------- 

macro expansion termination 

macro function ------------------------------------------------------------------ 

macro function directive ------------------------------------------------------- 

macro generation number ----------------------------------------------------- 

macro name---------------------------------------------------------------------- 
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macro replacement processing exclusion ------------------------------------ 245 
MACRO ----------------------- 29-22 -2-nn nnn nnn nn nnn nn nn nnn nnn nnn enn nnn en neces 238 
maximum count specification for conditional iterated expansion ----------- 233 
maximum length of a line --------------------------------------------------------- 13 
memory location of section -------------------------------------------------------- 50 
MMNEMONIC ----------------------------- anon nn nnn nnn nn nnn nn nnn === 12, 61, 67, 337 

assembler directive mnemonic ------------------------------------------------ 103 

executable instruction mnemonic and addressing mode combination --- 67 
\ (0) 0s 16, 83 
MO) -------------------------- 2229-2 nnn nnn nn nn nn nnn nnn nnn nnn nnn nn nn nen cn nn ennene 67, 85, 257 
MOVA --------------------- 7-2-2 n nnn nnn nn nn nn nn nnn nn nnn nnn nnn nnn nnn nnn en ncnee 67, 85, 257 
MOVS ---------------------2 22-2 nnn nn nnn nn nnn nnn nnn nn nnn nnn nnn nn nnn nnn nennee 91, 99, 102 
MOV ------------------------------ 2-2 n on nn nnn nnn nnn nn nnn nn nn nnn nnn nnn ene nenennne 68 
MOVX ------------------- 2-22 nn nnn nn nnn nn nnn nn nn nnn nnn nnn nnn nnn nnn nnn en nnn ennes 91,99, 102 
OS Qe 91, 99, 102 
MUL ------------------------------------ 2-22-2222 nnn onan nnn nn nn nnn nnn nnn nnn 73 
MULS ----------------------------------- 7-22-22 nnn nnn n nnn nnn nn nn nnn nnn anne 69 
multiple lines 

source statement across multiple lines --------------------------------------- 15, 94 
multiple source file assembly ----------------------------------------------------- 57, 281 
MULU -------------------------------------------------------------------------------- 69 
N 
NS ees 22 
OR A ca 330 
NEG --------------------------- 2-727-922-2922 n nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn n nnn 69 
NEGC -~---------------------------- 2-222 nn nn nnn nnn nn nnn nn nnn nnn nnn nn nnn nnn ences 69 
nesting of file inclusion ------------------------------------------------------------ 202 
new page insertion to source program listing----------------------------------- 189 
-NOCROSS_REFERENCE ----------------------------------------0 2-2-2202 20 202+ 300 
-NODEBUG ----------------------------------- 7-7-9 29-2222 nn nnn nnn nn nnn nanan nena one 
-NOLIST ----------------------------------------------------------------------------- 296 
NO ORIEGT <——ntoeeeeenieeeemnne 290 
NOP------------------------------ 2-22 n nn nnn nn nnn nnn nnn nnn nnn nnn nn nnn nnn n nnn en ence nes 72 
NOPOOL -------------------------n-n nn nnnnn nnn nnn nnn nn nn nnn nnn enna nnn nn nnn en nnnee 266, 267 
NOPX -------------------- 2-72-2922 nnnnn nn nnn nnn nn nnn nnn nn nnn nnn nn nnn nnn nen en ences 91, 99, 102 
NOPY ------------------------ 2922-2 nono nnn nn nn nnn nnn nen nnn nnn nnn nn nen n nnn nenene 91, 99, 102 
normalized number ----------------------------------------------------------------- 22,23, 25 
-NOSECTION------------------------ 7-29 --n 2 none nnn nnn nn nnn n nnn nen nnn e nen nnnnne 302 
-NOSHOW ---------------------------- 2 nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nn nnn ncn n en ncee 304 
-NOSOURCE----------------------- 27-222 -- nnn nn nnn nnn nnn nnn nn nnn nnn enna nn nennee 298 
NOT -------------------------------------------- 2-2-2222 n nnn n nnn nn nnn nnn nnn nnn nn nn 70 
not-a-number (NAN) --------------------------------------------------------------- 22.25 


HITACHI 385 


O 


-OBJECT ------------------------------------- 2-2-2 -n nnn nnn nnn nnn nnn nnn nnn nena nae =-- 290 

object code--------------------------------------------------------------------------- 29 

object converter --------------------------------------------------------------------- 6 

object file ---------------------------------------------------------------------------- 282 

object module ----------------------------------------------------------------------- 4, 6, 7, 167, 168 
object module assembler directive-------------------------------------------- 167 
object module command line option ----------------------------------------- 289 
object module name ------------------------------------------------------------ 194 
object module output control -------------------------------------------------- 168, 290 

object output file specification ---------------------------------------------------- 290 

OCBI --------------------------------------------------------------------------------- 82 

OCBP --------------------------- 22-2222 - nn nnn nnn nn nn nn nn nnn nnn n nnn nnn nena anne n= 82 

OCBWDB ------------------------- 22-2 -2n nnn n nnn nnn nnn nnn nnn nnn nnn nn nena nena nnn nnn=e- 82 

OCtal ---------------------------------------------------------------------------------- 19, 196 

operand ------------------------------------------------------------------------------ 12, 14, 61 

operating system-------------------------------------------------------------------- 281 
return code to operating system----------------------------------------------- 281 

operation ----------------------------------------------------------------------------- 12, 13, 61 
internal processing ------------------------------------------------------------- 39 
operation precedence ----------------------------------------------------------- 33 
executable instruction and operation size combination ------------------- 67 

operator ------------------------------------------------------------------------------ 16, 31 
operator association rule ------------------------------------------------------- 33 
operator precedence ------------------------------------------------------------ 33 

©) Cre 66, 70 

0) 6 114 

-OUTCODE ------------------------------------------------------------------------- 322 

.OUTPU 1 ---------------------------------------------------------------------------- 168 

overflow boundary ----------------------------------------------------------------- 22 

P 

PABS ------------------------------ 2 n-ne n nn nnn nnn nn nn nn nnn nn nnn nnn nn nnn nnn en nn nnn 91,95, 98 

PADD ------------------------------ 22-22-22 noon nnn nnn nnn nnn nnn nnn nnn nnn n nn nnennnne 91, 95, 98 

PADDC ------------------------- 2-22-2222 nnn nn nn nnn nnn nn neem nnn nen nen nnn nnn neennnne 91,95, 98 

NG) eee 

PAND ------------------------------- 22-222 n nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nne 

parallel operation instruction 

parenthesis -------------------------------------------------------------------------- 

PC -n---n 2-2-2 n 22a nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nn nnn nnn nnnenne 
value of PC ---------------------------------------------------------------------- 

PC relative with displacement 

PCLR------------------------------- 22-22 -n nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn n nen nene 

PCMP --------------------------- 2-2-9222 n nnn nnn nn nnn nnn nnn nnn nnn nnn nn nennnee 

PCOPY ----------------------------- 2-222 n nnn nnn nnn nnn nn nnn nnn nnn nnn nnn n nnn eennnne 

PDEC ------------------------------- 2-22-22 noone nn nnn nnn nnn nnn nnn nn nn nn nana 
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sigma eect acct ercesssirnleatoa nei enicoemnanaanacpomepaleaie 91, 95, 98 


PINC ------------------------------------------------ 2-22-22 2-222 -22-nn anna nena nnn nae 91, 95, 98 
PLDS ------------------------------ == 2-2 nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn ene 91, 95, 98 
PMULS ------------------------------------- 7-9 2-2-2 n 22 n nn nnn nn nnn nanan anne nn nnn anes 91, 95, 98 
PNEG ----------------------------- 2-922-922-2222 n 2a nnn nnn nnn nnn nena nnn naan nanan ee 91, 95, 98 
«POOL -~---------------------- 2-92-2322 nn nn nn nn nn nnn nnn nnn nnn nnn nnn nnn nanan nnn nneene 260, 262, 267 
10) Ce 91, 95, 98 
positional specification------------------------------------------------------------- 247 
\) Co 16, 68 
precedence --------------------------------------------------------------------------- 33 
PREF --------------------------------------------------- 2-222 n nnn nanan nnn nan n-- === == 76 
preprocessor expansion 
error generation during preprocessor expansion---------------------------- 229 
preprocessor expansion result output ----------------------------------------- 317 
preprocessor replacement character string definition-------------------------- 217, 315 
preprocessor variable --------------------------------------------------------------- 205 
character preprocessor variable definition ----------------------------------- 215, 313 
integer preprocessor variable definition-------------------------------------- 2AD, SAL 
PRINT ---------------------------- 22-22-22 nnn nn nnn nn nnn nnn nnn nnn nnn nnn nena nnn nn = 179 
PRND------------------------------- 72-22-2222 22 nnn nn nn nnn nnn nnn nnn nnn nnn nn nnnn= 91, 95, 98 
PROGRAM  ---------------------- 22-22-9222 n nnn nnn nnn nnn neem nnn nnn nn nn nnn enn n nee 194 
program counter (PC) -------------------------------------------------------------- 16, 62, 64, 68 
value of program counter ------------------------------------------------------ 86 
program length---------------------------------------------------------------------- 337 
PSHA -------------------------------- 22-2222 n anna nnn nnn nnn nnn nnn nnn nnn ence nn nennnne 91, 95, 96, 98 
PSHL ------------------------------------ 2-22-2222 2a anna nnn nnn nnn nnn nnn anne nnnnnnnee 91, 95, 96, 98 
PSTS --------------------------------- 2-2-2 --n nnn n nnn nnn nnn nnn nnn nnn anne nnn nn nn= 91, 95, 98 
PSUB ------------------------------------ 2-22 ---n oon nnn nnn nnn nena nnn nena nn nnn nnn nnn n= 91, 95, 99 
PSUBC ------------------------------ 2-9-2292 --- 2 nnn nnn nnn nnn nnn nnn anna nnnn nnn n nen ne 91, 95, 99 
PX OR ---------------------------- 2-22 n-ne nn nnn nnn nnn nnn nn nnn nnn nnn nn nn nnn nnn n eens 91, 95, 99 
Q 
QU -n-n nnn nnn nanan nnn nnn nnn nnn nn nn nn nnn nnn nn nnn nnn nnn nn nnn nnn nnn nnn nnn nnnes 19 
QNAN ----------------------- 2-222 n nnn nnn nnn nnn nnn nnn ncn nn nnn nnn nnn nnn nnn nnnes 22, 
R 
RO ------------------------------------ 2-222 n nnn nn nn nnn nnn nnn nnn nn nnn nnn nn nn nnn nnn n= 16, 62, 68 
R | 5--------------------------- 2-2 n nn nn nn nnn nnn nnn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn ne 16 
Tadix ------------------------------------------ 2-2-2222 22a n nnn nn nnn nnn n nen nnn nee 19 
default radix for integer constant --------------------------------------------- 196 
-RADIX ---------------------------------------- 292-222-222 222 n enna nn nnn nnn nnn nnn nnee 196 
RE --------------------------------- 2-22-2222 --- 222 nn nena nn nnn nnn nn nnn nnn nn nnn nana 16, 83, 271 
REG -------------------------------------- 2-72-22 22-22-22 nnn nnn nnn anne nena anne na -- 123 
register direct ------------------------------------------------------------------------ 62 
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register indirect --------------------------------------------------------------------- 62 


register indirect with displacement ------------------------------------------ 62 
register indirect with index---------------------------------------------------- 62 
register indirect with post-increment ---------------------------------------- 62 
register indirect with pre-decrement ----------------------------------------- 62 
register Name------------------------------------------------------------------------ 16 
register name alias definition----------------------------------------------------- 123 
relative address --------------------------------------------------------------------- 50 
relative address section -------------------------------------------------------- 50, 51 
relative address section declaration ------------------------------------------ 112 
relative address symbol -------------------------------------------------------- 52 
relative address value ---------------------------------------------------------- 52, 115 
relative path ------------------------------------------------------------------------- 202, 203 
relative value ------------------------------------------------------------------------ 52 
REPEAT ------------------------------------------ 2-22-20 n nn nnn nn nnn nnn nn nnn nnn en nee 272 
repeat control instruction---------------------------------------------------------- 83 
repeat loop 
automatic repeat loop generation function ---------------------------------- 271 
extended instruction related to automatic repeat loop generation ------- 272 
repeat count---------------------------------------------------------------------- 272 
start address and end address ------------------------------------------------- 272 
replacement character string definition ----------------------------------------- 217, 315 
replacement symbol ---------------------------------------------------------------- 206 
RES ------------------------------------- 2-2-9 20-2 nn nnn n nnn nnn nnn nnn nn nnn nn nen eee 149 
reserved Word ------------------------------------------- 2922-22-22 2-2 -n nnn naan anna 16 
return code to operating system -------------------------------------------------- 281 
RN) -------------------- 2-2-2 2922 nnn nnn nn nnn nnn enna nn nena nn nnn nn nnn nnn nn nnn nn nnn nn nae 16, 62, 64, 68 
Rn_BANK ------------------------------------- 2-222 2--2n nnn nanan nn nnn nn nn nn nnn nen= 16 
ROTCL ---------------------------------- 7-2-2222 -2n nnn nnn nn nnn nnn nnn nn nen nnn nn nnn 71 
NO 0 Coe 71 
ROTL --------------------------------------- 2-22-2222 n nnn nn nnn nnn nn nnn nn nnn nnn nn nnn 71 
ROTR ------------------------------- 22-2 n nnn nn nn nnn nnn nnn nnn nnn nnn nnn nn nen nnn ennnns 71 
-ROUND ---------------------------------- 2-2-9222 -n on nnn nnn nn nnn nn nnn nn nn nnnennene 330 
rounding ----------------------------------------------------------------------------- 330 
RS ------------- $22 22a nnn nn nnn nn nnn nn nn nnn nnn nnn nn nn nen nnn nnn nnn nnn nen enenne 16, 83, 271 
RTE ---------------------------------- 2-22-22 n nnn nnn nnn nnn nn nnn nnn nn nn nen nn nnnneee 72, 85 
RUS ---------------------- 2-22-22 n nn nnn nnn nn nnn nnn nn nnn nnn nnn nnn cn nen nnn nn nen ennenens 71, 85 
S 
S-type-format load module-------------------------------------------------------- 6,7 
sample program -------------------------------------------------------------------- 338 
SSDATA ---------7----7 2-22-22 n nn nnn nn nnn nnn nnn nnn nnn nn nn nnn nnn nnn nn nnn nnn nnn nnnane 133 
SSDATAB ------------------------ 22-22 nanan nnn nnn nn nnn nnn nn nn cn cnn nnn nennnnns 135 
SSDATAC  ------------------2 2-22 2n nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnnnnnnne 138 
SDATAZ ---------------------------- 2-2-2 22-22 nn nnn nnn nnn nn nnn nnn nn nnnnn nnn 140 
\\ oa hn ao 96 
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S€CtION --------------------------- 2-2-2 nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn enna nn 32, 45, 109 


code section ---------------------------------------------------------------------- 45, 109 

common SectiOn ----------------------------------------------------------------- 47, 109 

data section----------------------------------------------------------------------- 46, 109 

dummy section------------------------------------------------------------------- 48, 109 

memory location----------------------------------------------------------------- 50 

section attribute------------------------------------------------------------------ 109 

section boundary alignment value -------------------------------------------- 109 

section declaration -------------------------------------------------------------- 109 

stack SectiONn-------------------------------------------- 20-9220 --nn nn -nn nena n nnn 48, 109 

start and restart of section------------------------------------------------------ 110, 111 
SECTION ------------------- 2-9-2222 -n nnn nn nnn nnn nn nnn nnn nnn nn nnn n nn ncn ncn nennnns 109 
-SECTION ----------------------------- 2-2-2222 --n nnn nn nnn nnn nn nnn cence nnn n nnn ncn nee 302 
section information listing--------------------------------------------------------- 345 

section information listing output control ----------------------------------- 302 
section nNaMe---------------------------------------------- 2-2 n none nn nena nena nnn =- 16, 54, 109 
section Set ---------------------------------------------------------------------------- 32 

section set operation ------------------------------------------------------------ 32 
separate assembly ------------------------------------------------------------------- 57 
SETRC -----------------2-- 2222-2 n-nonane nnn nn nnn nn nnn nnn e nn nen nn nen n en nenee 66, 83, 272 
SETS ----------------------------- 29-22-22 -n nnn nn nnn nn nnn nn nnn nnn nen nnn nen n cnn en nen a 
BET seeeiew cence 72 
Qf ----------------- 2-22 nnn nnn nn nnn nn nn nnn nnn nn nn nnn nnn nnn nn nen nnn nnn nn nnn n enn nens 96 
SGR ~----------- 2-22 -n nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn n nnn nen nnnnnne 16, 80 
SH] ------------------- 2222-22-22 n-nonane nnn nnn nn nnn nnn nnn nn nnn nnn nnn n nnn nene 106, 283, 288 
SH-] --------------------2 22-222 n nnn nnn anne nn nnn nnn nnn nnn nnn nen nn nn nnn nnn nee n nee 106, 288, 330, 332 
SH2 ---------------------- 2-2-2 n enna nnn nn nn nnn nnn nnn nn nnn nnn nnn nnn cnn nn nnn nnne 106, 283, 288 
SH-2 --------------- 2-2-2 n nnn nn nnn nnn nnn nnn nnn nena 106, 288, 330, 332 
SHE ------------------- 2-22-22 nnn anna nn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn ennen 106, 283, 288 
SH-2E ~-----------------n nnn a nnn nnn nnn nnn nnn nn nnn nn nnn nn nen nnn ne nn nen nnn n cnn ncene 106, 288, 330, 332 
SHB ---------- 2-2-2222 n nnn nn nnn nnn nnn nnn nnn nn nnn nn nnn nnn nen enn nnn nese enna nene 106, 283, 288 
SH-3 --------------- 2-22 -n nnn nena nnn nnn nn nnn nnn nnn nnn nnn nnn nen enna 106, 288, 330, 332 
SH3 DSP -------~-------------- 2222-2 n enna nn nen nnn nnn nnn n enn nn eens 106, 283, 288 
SH3-DSP ---------------------- 2-22-22 n nnn nnn nnn nnn nnn nen nnn nn nn nce n nen n enn n nnn nees 106, 288, 330, 332 
SHBE ----------2-- 2-2-2222 n nnn nn nnn nnn nnn nnn nnn nn nnn nnn nn nen nnn ene nnn nanan 106, 283, 288 
SH-3E -------------- 2-22 nnn n nnn nnn nnn nnn nnn nnn nnn nnn cnn ene n enn enne 106, 288, 330, 332 
SH4 ------------------------ 2-22-22 nnn nnn nnn nnn nnn nnn nnn cence nen nnn sens cenecene 106, 283, 288 
SH-4 ----------------- 2-2-2222 nnn nnn nnn nn nn nnn nnn nnn nnn nee nnn en nnn n nnn ennennn 106, 288, 330, 332 
SHAD) -~------------------- 2-22-22 2m nnn nn nn nnn nnn nn nnn nn nnn nnn nn nnn nnn ennnnen 76 
SHAL ------------------- 2-22-2222 neem nn nnn nnn nn nnn nnn nnn nn nn cnn nn nen nnn n enn nnnnnne 71 
SHAR ~~-------- 22-2222 -n nn nnn n nnn nn nnn nnn nn nnn nnn nnn enn enn enn en nen n nnn nnne 71 
SHCPU environment variable----------------------------------------------------- 283 
SHDSP ------------------------- 2-22-22 2a anna nnn nnn nnn nnn n nnn nnn nen nen nnn ennenee 106, 283, 288 
SH-DSP ---------------------- 7-2-2222 22-22 n nn nnn nnn nnn nnn anne nnn nnn n nce n ene nncene 106, 288, 330, 332 

SH-DSP instruction ------------------------------------------------------------- 91 
shift instruction --------------------------------------------- 22-2 n nnn nn nnn nnnn nn nnn 71, 76 
shift JIS code ------------------------------------------------------------------------ 13, 20, 40, 320, 322 
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sign bit ------------------------------------------------------------------------------- 
simulator/debugger----------------------------------------------------------------- 
single data move instruction ----—---——_-—------___---__-_-----_-_—.--—__-__--- 


input source file ----------------------------------------------------------------- 
assembly of multiple source files --------------------------------------------- 
source program -------------------~------------------------------------------------- 
assembly-language source program ------------------------------------------ 


source program listing ------------------------------------------------------------- 
blank line output to source program listing 
source program listing header setting --------------------------------------- 
source program listing new page insertion---------------------------------- 
source program listing output control --------------------------------------- 
source statement -------------------------------------------------------------------- 
source statement across multiple lines --------------------------------------- 
coding of source statement ---------------------------------------------------- 
source statement structure ----------------------------------------------------- 


stack pointer (SP) ------------------------------------------------------------------ 
StACIS SECU hexeseeseesasesteseeeeeseeees acest cene ase ees 
caution---------------------------------------------------------- 22-82-88 === nee 
stack séctionideclardtiOni---s--<esnqs6nntescentccend enn ccneaeidendunnbieentic 
start address for simulation ------------------------------------------------------- 


390 HITACHI 


SUB -------------------------------------------- 2-7-2 2-22-22 n nnn nena nnn nn nnn nn nnn 69 

SUBC ------------------------- 2-2-2222 nnn nn nnn nnn nnn nn nnn nnn nn nnn nnn nnn nn nnn nn nnnne 69 

-SUBCOMMAND ----------------------- 2-2 ---9 22 ---- nnn nnn nnnn nnn nn nn nena anne 327 

subcommand file name ------------------------------------------------------------ 327 

SUBST R----------------- 22-2 nnn nnn nn nnn nnn nnn nnn nnn nnn nn nnn nnn neces ences 254 

SUBV ------------------------- 222-92 -nn nnn n nn nnn nn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnne 69 

supplement debugging information file (ELF/DWARF supplement 

information) ------------------------------------------------------------------------- 169, 292 

SWAP ------------------ 2-2-9 n nn none nnn nnn nn cence nn nn nnn nnn nnn nen e nnn ncnnen 68 

ee es 96 

GY wen n-n nnn anne nnn nnn nnn nnn nn nn nn nn nnn nnn nnn nen nnn nnn neem n enn 96 

symbol -------------------------------------------------------------------------------- 12, 16, 63, 65, 68 
absolute address symbol -------------------------------------------------------- 52 
address symbol------------------------------------------------------------------- 16 
coding of symbol ---------------------------------------------------------------- 18 
constant symbol ----------------------------------------------------------------- 16 
functions of symbol ------------------------------------------------------------- 16 
internal symbol ------------------------------------------------------------------ 18 
replacement symbol ------------------------------------------------------------- 206 
relative address symbol --------------------------------------------------------- 52, 
symbol definition ---------------------------------------------------------------- 53 
symbol reference ---------------------------------------------------------------- 55 

symbolic debug information------------------------------------------------------- 171 
symbolic debug information output------------------------------------------- 171 

system control instruction --------------------------------------------------------- 72, 75, 77, 79, 82, 84 

T 

target CPU ---------------------------------- 22-20 n-n nn nnn nnn nnn nnn n enna n enna nnnnn=e 106, 283, 288 

TAS -------------- 2-22 n nnn nn nnn nnn nnn nnn nnn cnn nnn nnn cena nnn 70 

t€LM ------------------------------ =n 2-2 nn nena n nnn nnn nn nnn nnn nnn nn nnn nena nnn 31 

TRAPA -~------------- 2922-2 nnn nnn nnn nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn enn nnn nnn nnnn 66, 72, 85 

TST  ------------------------n nner nnn nn nnn nn nn nn nn nnn nnn nn nnn nnn nnn nnn nnn nnn 66, 70 

U 

underflow boundary ---------------------------------------------------------------- 22 

upper/lower-case letter distinction ----------------------------------------------- 337 

Vv 

VBR ------- 2-2-2 nnn nn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nena 16, 68 

», 4 

XDATA ~nn-----n 2-2-2 nn nnn nnn nnn nnn nnn nnn nnn nnn n nnn cnet nn nnn ne nen nes 147 
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XO) -nn---n anon n nnn nn nnn nn nnn nnn nnn nn nnn nen nnn nnn nnn een nnn nnn en nnn n nnn 16, 96, 101 
X | -------------- 22-2 - nn nn nn nnn nn nn nn nn nnn nn nnn nnn nn nnn nnn nnn nn nen nnn nnn ne ne ne 16, 96, 101 
XD) ~------------ 222-2 nn nnn nn nnn nnn nn nnn nnn nnn nnn nnn nnn renee n enn nnn n cnn 16, 80 
XMTRX ------------2----nn nnn nnn nnn nnn nnn nn nnn nnn nn nnn nnn nnn nnn nee nnn nena nee 16, 80 

>, € @) eee 66, 70 

XT RCT ------------------ 22a nn nnn nn nn nnn nnn nn nn nnn nnn nn nnn nnn nnn nnn nnn nnn nen nes 68 

Y 

Y data move instruction ----------------------------------------------------------- 93, 102 
YO) -nn--n-n nnn a nnn nn nn nn nn nnn nnn nnn nnn nen nen nen nn nnn nnn nnn eenenen nnn nnnns 16, 96, 101 
Y | wna n------- no-one nnn nn nnn nn nnn nnn nn nnn nn nnn nnn nnn nnn noone nn nena =n ee 16, 96, 101 
Z 

ZERO) ----------------2 2-2-2 nnn nnn nnn nnn nnn nnn nnn nn nen nnn nen ne nen nee n cee n ene 330 

ZOTO wn nnn === == nnn nnn nn nnn nnn nn nn nnn nn nnn nnn nnn nn nnn nnn nnn nn nnn nn nn nnn nnn nnn nnne 22,25 
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